This repository has been archived by the owner on Aug 10, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 17
/
otf2bdf.html
289 lines (242 loc) · 8.63 KB
/
otf2bdf.html
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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<!-- $Id: otf2bdf-doc.html,v 1.2 2005/11/09 22:36:04 mleisher Exp $ -->
<html>
<head>
<title>OTF2BDF(1) manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>
<h2><a name='sect0' href='#toc0'>Name</a></h2>
otf2bdf - OpenType to BDF font converter (<em>formerly known as
<code><b>ttf2bdf</b></code></em>)
<p>
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>otf2bdf</b> [<i>options</i>]
font.{ttf,otf}
<p>
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<i>otf2bdf</i> will convert an OpenType font to a BDF
font using the Freetype2 renderer (http://www.freetype.org).
<p>
<h2><a name='sect3' href='#toc3'>Options</a></h2>
<i>otf2bdf</i>
accepts the following command line arguments:
<p> <p>
<dl>
<dt><i>-v</i> </dt>
<dd>print warning messages
when the font is converted. </dd>
</dl>
<p>
<dl>
<dt><i>-n</i> </dt>
<dd>disable glyph hinting. </dd>
</dl>
<p>
<dl>
<dt><i>-p</i> n </dt>
<dd>set the desired
point size (see default value by running the program with the -h option).
</dd>
</dl>
<p>
<dl>
<dt><i>-et</i> </dt>
<dd>display a list of the platforms and encodings available in the font.
The default values, compiled into the program, are a platform of 3 (Microsoft)
and encoding of 1 (ISO10646). If the font does not contain the default platform
and encoding, the fallback will be the Apple ISO10646 encoding. </dd>
</dl>
<p>
<dl>
<dt><i>-r</i> n </dt>
<dd>set
both the horizontal and the vertical resolution (see default value by running
the program with the -h option). The minimum is 10dpi and the maximum is
1200dpi. </dd>
</dl>
<p>
<dl>
<dt><i>-rh</i> n </dt>
<dd>set the horizontal resolution (see default value by running
the program with the -h option). The minimum is 10dpi and the maximum is
1200dpi. </dd>
</dl>
<p>
<dl>
<dt><i>-rv</i> n </dt>
<dd>set the vertical resolution (see default value by running
the program with the -h option). The minimum is 10dpi and the maximum is
1200dpi. </dd>
</dl>
<p>
<dl>
<dt><i>-o</i> outfile </dt>
<dd>sets the output filename (default output is to stdout).
</dd>
</dl>
<p>
<dl>
<dt><i>-pid</i> id </dt>
<dd>set the platform id for selecting the character map (see default
value by running the program with the -h option). </dd>
</dl>
<p>
<dl>
<dt><i>-eid</i> id </dt>
<dd>set the encoding
id for selecting the character map (see default value by running the program
with the -h option). </dd>
</dl>
<p>
<dl>
<dt><i>-c</i> c </dt>
<dd>set the character spacing. This should be one of
‘P’ for proportional, ‘M’ for monospace, or ‘C’ for character cell. By default,
the spacing of a font will be automatically determined to be either ‘M’ or
‘P’ according to values provided in the font. </dd>
</dl>
<p>
<dl>
<dt><i>-f</i> name </dt>
<dd>set the foundry name
used in the XLFD name. The default value is ‘Freetype’. </dd>
</dl>
<p>
<dl>
<dt><i>-t</i> name </dt>
<dd>set the typeface
name used in the XLFD name. By default, <i>otf2bdf</i> will attempt to get a name
from the font first and then it will use the name supplied with this command
line option, and if all else fails, it will use the name ‘Unknown’. </dd>
</dl>
<p>
<dl>
<dt><i>-w</i> name
</dt>
<dd>set the weight name used in the XLFD name. If this value is not supplied,
the default value is assumed to be ‘Medium’. Some common values for this
are ‘Thin’, ‘Delicate’, ‘ExtraLight’, ‘Light’, ‘Normal’, ‘Medium’, ‘SemiCondensed’, ‘Condensed’,
‘SemiBold’, ‘Bold’, ‘Heavy’, ‘ExtraBold’, and ‘ExtraHeavy’. </dd>
</dl>
<p>
<dl>
<dt><i>-s</i> name </dt>
<dd>set the slant name
used in the XLFD name. If this value is not supplied, the default value
is assumed to be ‘R’, for Roman. Some common values for this are ‘R’ for Roman,
‘I’ for Italic, ‘O’ for Oblique, ‘RI’ for Reverse Italic, and ‘RO’ for Reverse
Oblique. </dd>
</dl>
<p>
<dl>
<dt><i>-k</i> name </dt>
<dd>set the width name used in the XLFD name. The default is
‘Normal’. </dd>
</dl>
<p>
<dl>
<dt><i>-d</i> name </dt>
<dd>set the additional style name used in the XLFD name. The
default is an empty string. </dd>
</dl>
<p>
<dl>
<dt><i>-u</i> char </dt>
<dd>set the character used to replace the
dashes/spaces in a font name. The default is the space character. </dd>
</dl>
<p>
<dl>
<dt><i>-l</i> subset
</dt>
<dd>define a list of character codes which will be used to select a subset
of glyphs from the font. The syntax of the subset string is the same as
the syntax for selecting subsets in X11 XLFD font names. Example: <p>
% otf2bdf
-l ’60 70 80_90’ font.ttf -o font.bdf <p>
The command above will only generate the
glyphs for codes 60, 70, and 80 through 90 inclusive. Glyphs that are not
in the subset are not generated. </dd>
</dl>
<p>
<dl>
<dt><i>-m</i> mapfile </dt>
<dd>specifies a mapping file which
will reencode the BDF font when it is generated. Any glyphs with codes
that do not have a mapping will not be generated. <p>
The remapping file should
begin with two lines, one which starts with REGISTRY followed by the character
set registry and one which starts with ENCODING followed by the encoding.
An example from the iso8859.2 file: <p>
REGISTRY ISO8859 <br>
ENCODING 2 <p>
The remapping data should be two columns of hexadecimal numbers,
separated by spaces or tabs. The first column should have the code which
should be used in the BDF font. The second column should be the hexadecimal
code of the glyph in the "cmap" table otf2bdf is using. An example mapping
file is provided which will map fonts from Unicode (the default "cmap"
table) to ISO8859-2. <p>
Unicode is not the only option. If you choose another
platform and encoding ID on the command line, then the remapping is assumed
to map from the chosen platform and encoding to some other character set.
<p> </dd>
</dl>
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='xmbdfed.1'>xmbdfed(1)</a>
, <a href='xfed.1'>xfed(1)</a>
, <a href='bdftopcf.1'>bdftopcf(1)</a>
, <a href='bdftosnf.1'>bdftosnf(1)</a>
<br>
<i>Glyph Bitmap Distribution Format (BDF) Specification</i>, Application Note
5005, Adobe System Inc, 1993 <br>
<i>X Logical Font Description Conventions</i>, X Consortium
<p>
<h2><a name='sect5' href='#toc5'>Acknowledgments</a></h2>
<p> The
FreeType project for providing the renderer! <br>
Robert Wilhelm <robert@physiol.med.tu-muenchen.de> for pointing out a crucial
problem with the pre-1.0 code. <br>
Lho Li-Da <ollie@ms1.hinet.net> for problem reports. <br>
Adrian Havill <havill@threeweb.ad.jp> for unintentionally pointing out a missing
feature. <br>
Richard Verhoeven <rcb5@win.tue.nl> for problem reports and patches. <br>
Choi Jun Ho <junker@jazz.snu.ac.kr> whose implementation provided some nice
new features. <br>
Pavel Kankovsky <peak@kerberos.troja.mff.cuni.cz> for providing some critical
metrics fixes and other improvements. <br>
Matti Koskinen <mjkoskin@sci.fi> for pointing out a problem. <br>
Eugene Bobin <gene@ftim.ustu.ru> for mapping tables. <br>
Oleg N. Yakovlev <yashka@optima.dnepropetrovsk.ua> for pointing out a problem.
<br>
Bertrand Petit <elrond@phoe.frmug.org> for additional functionality. <br>
Roman Czyborra <czyborra@cs.tu-berlin.de> for pointing out some problems. <br>
Mike Blazer <blazer@mail.nevalink.ru> for some Window’s compilation advice. <br>
Solofo Ramangalahy <solofo@mpi-sb.mpg.de> for contributing some mapping tables.
<br>
Antoine Leca <Antoine.Leca@renault.fr> for mapping table suggestions. <br>
Patrick Hagglund <patrik.hagglund@bredband.net> for Freetype2 patches to xmbdfed.
<br>
Christos Tountas <cvt@sprynet.com> for finding problems.
<br>
Nelson Beebe <beebe@math.utah.edu> for finding problems.
<h2><a name='sect6' href='#toc6'>Author</a></h2>
Mark Leisher
<br>
Computing Research Lab <br>
New Mexico State University <br>
Email: mleisher@crl.nmsu.edu <p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Options</a></li>
<li><a name='toc4' href='#sect4'>See Also</a></li>
<li><a name='toc5' href='#sect5'>Acknowledgments</a></li>
<li><a name='toc6' href='#sect6'>Author</a></li>
</ul>
</body>
</html>