summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/pbmtopk.1
blob: e686d6027e7f26fcef7ea650f98242876e59ec65 (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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pbmtopk User Manual" 0 "06 August 1990" "netpbm documentation"

.SH NAME
pbmtopk - convert a PBM image into a packed (PK) format font

.UN synopsis
.SH SYNOPSIS

\fBpbmtopk\fP
\fIpkfile\fP[\fB.pk\fP]
\fItfmfile\fP[\fB.tfm\fP]
\fIresolution\fP
[\fB-s\fP \fIdesignsize\fP]
[\fB-p\fP \fInum\fP \fIparam\fP...]
[\fB-C\fP \fIcodingscheme\fP]
[\fB-F\fP \fIfamily\fP]
[\fB-f\fP \fIoptfile\fP]
[\fB-c\fP \fInum\fP]
[\fB-W\fP \fIwidth\fP]
[\fB-H\fP \fIheight\fP]
[\fB-D\fP \fIdepth\fP]
[\fB-I\fP \fIital\fP]
[\fB-h\fP \fIhoriz\fP]
[\fB-v\fP \fIvert\fP]
[\fB-x\fP \fIxoff\fP]
[\fB-y\fP \fIyoff\fP]
[\fIpbmfile\fP ...]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpbmtopk\fP reads PBM images as input and produces a packed (PK)
font file and a TFM (TeX font metric) file as output. The resolution
parameter indicates the resolution of the font, in dots per inch. If
the filename "-" is used for any of the filenames,
\fBpbmtopk\fP uses Standard Input or Standard Output.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpbmtopk\fP recognizes the following
command line options:


.TP
\fB-s\fP \fIdesignsize\fP
Sets the design size of the font, in TeX's points (72.27pt to the inch). The
default design size is 1. The TFM parameters are given as multiples of the
design size.

.TP
\fB-p\fP \fInum\fP \fIparam\fP...
Sets the first num font parameters for the font. The first seven
parameters are the slant, interword spacing, interword space
stretchability, interword space shrinkability, x-height, quad width,
and post-sentence extra space of the font. Math and symbol fonts may
have more parameters; see The TeXbook for a list of these. Reasonable
default values are chosen for parameters which are not specified.

.TP
\fB-C\fP \fIcodingscheme\fP
Sets the coding scheme comment in the TFM file.

.TP
\fB-F\fP \fIfamily\fP
Sets the font family comment in the TFM file.

.TP
\fB-f\fP \fIoptfile\fP
Reads the file optfile, which should contain a lines of the form:

.nf
   filename xoff yoff horiz vert width height depth ital

.fi
.sp
The PBM files specified by the filename parameters are inserted
consecutively in the font with the specified attributes. If any of the
attributes are omitted, or replaced with "*", a default
value will be calculated from the size of the bitmap. The settings of
the -W, -H, -D, -I, -h, -v, -x, and -y options do not affected
characters created in this way.  The character number can be changed
by including a line starting with "=", followed by the new
number.  Lines beginning with "%" or "#" are
ignored.

.TP
\fB-c\fP \fInum\fP
Sets the character number of the next bitmap encountered to num.

.TP
\fB-W\fP \fIwidth\fP
Sets the TFM width of the next character to width (in design size
multiples).

.TP
\fB-H\fP \fIheight\fP
Sets the TFM height of the next character to height (in design
size multiples).

.TP
\fB-D\fP \fIdepth\fP
Sets the TFM depth of the next character to depth (in design size
multiples).

.TP
\fB-I\fP \fIital\fP
Sets the italic correction of the next character to ital (in
design size multiples).

.TP
\fB-h\fP \fIhoriz\fP
Sets the horizontal escapement of the next character to horiz (in
pixels).

.TP
\fB-v\fP \fIvert\fP
Sets the vertical escapement of the next character to vert (in pixels).

.TP
\fB-x\fP \fIxoff\fP
Sets the horizontal offset of the next character to xoff (in
pixels).

.TP
\fB-y\fP \fIyoff\fP
Sets the vertical offset of the next character to yoff (in pixels,
from the top row).



.UN seealso
.SH SEE ALSO
.BR "pktopbm" (1)\c
\&, 
.BR "pbm" (5)\c
\&

.UN author
.SH AUTHOR
.PP
Adapted from Tom Rokicki's pxtopk by Angus Duggan <\fIajcd@dcs.ed.ac.uk\fP>.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pbmtopk.html
.PP