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
|
\
.\" 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 "Picttoppm User Manual" 0 "17 June 2006" "netpbm documentation"
.SH NAME
picttoppm - convert a Macintosh PICT file to a PPM
.UN synopsis
.SH SYNOPSIS
\fBpicttoppm\fP
[\fB-verbose=\fP\fIn\fP]
[\fB-fullres\fP]
[\fB-noheader\fP]
[\fB-quickdraw\fP]
[\fB-fontdir\fP \fIfile\fP]
[\fIpictfile\fP]
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpicttoppm\fP reads a PICT file (version 1 or 2) and outputs a PPM
image.
.PP
PICT is an image format that was developed by Apple Computer in 1984 as the
native format for Macintosh graphics. A PICT image is encoded in QuickDraw
commands. The PICT format is a meta-format that can be used for both bitmap
images and vector images. PICT is also known as "Macintosh Picture"
format, or the QuickDraw Picture format.
.PP
PICT files are primarily used to exchange graphics between various
Macintosh applications.
.PP
In MacOS X, PDF replaces PICT as the main graphics format.
.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
\&), \fBpicttoppm\fP recognizes the following
command line options:
.TP
\fB-fontdir \fP\fIfile\fP
Make the list of BDF fonts in \fIfile\fP available for use by
\fBpicttoppm\fP when drawing text. See below for the format of the
fontdir file. This is in addition to the built-in fonts and those in
the file \fBfontdir\fP.
.TP
\fB-fullres\fP
Force any images in the PICT file to be output with at least their
full resolution. A PICT file may indicate that a contained
image is to be scaled down before output. This option forces images
to retain their sizes and prevent information loss.
This option disables all PICT operations except images.
.TP
\fB-noheader\fP
Do not assume the first 512 bytes of the file are a header. All PICT
files have such a header, but this is useful when you have PICT data that was
not stored in the data fork of a PICT file.
.TP
\fB-quickdraw\fP
Execute only pure quickdraw operations. In particular, turn off
the interpretation of special PostScript printer operations.
.TP
\fB-verbose=\fP\fIn\fP
Print a whole bunch of information about the PICT file and the conversion
process that only \fBpicttoppm\fP hackers really care about.
.sp
\fIn\fP is the verbosity level, 0-2.
.sp
Before Netpbm 10.98 (March 2022), this option is a flag option that you
specify multiple times to specify increasing verbosity.
.UN limitations
.SH LIMITATIONS
The PICT file format is a general drawing format. \fBpicttoppm\fP
does not recognize all the drawing commands, but it does fully
implement all image commands and mostly implements line, rectangle,
polygon and text drawing. It is useful for converting scanned images
and some drawing conversion.
.PP
With \fB-fullres\fP, \fBpicttoppm\fP ignores text drawing commands.
Beginning in Netpbm 10.45 (December 2008), it issues a warning message
when it omits text for this reason.
.UN fonts
.SH FONTS
.PP
Some of the information in a PICT file is text, with a number
indicating the font in which the text is supposed to rendered.
\fBpicttoppm\fP has one built-in font, but you can add others by
directing \fBpicttoppm\fP to BDF font files, which you do with font
directory files.
.PP
\fBpicttoppm\fP automatically uses the file named \fBfontdir\fP
in the current directory, if it exists. You may specify an additional
font directory file with the \fB-fontdir\fP option.
.PP
Obviously the font definitions are strongly related to the
Macintosh. You can find more font numbers and information about fonts
in Macintosh documentation.
.UN fontdir
.SS Font Directory File Format
.PP
Each line in the file is either a comment or font information. A
comment begins with \fB#\fP. The font information consists of 4
whitespace separated fields. The first is the font number, the second
is the font size in pixels, the third is the font style and the fourth
is the name of a BDF file containing the font. The BDF format is
defined by the X Window System and is beyond the scope of this document.
.PP
The font number indicates the type face. Here is a list of known
font numbers and their faces.
.TP
0
Chicago
.TP
1
application font
.TP
2
New York
.TP
3
Geneva
.TP
4
Monaco
.TP
5
Venice
.TP
6
London
.TP
7
Athens
.TP
8
San Franciso
.TP
9
Toronto
.TP
11
Cairo
.TP
12
Los Angeles
.TP
20
Times Roman
.TP
21
Helvetica
.TP
22
Courier
.TP
23
Symbol
.TP
24
Taliesin
.PP
The font style indicates a variation on the font. Multiple
variations may apply to a font and the font style is the sum of the
variation numbers which are:
.TP
1
Boldface
.TP
2
Italic
.TP
4
Underlined
.TP
8
Outlined
.TP
16
Shadow
.TP
32
Condensed
.TP
64
Extended
.UN seealso
.SH SEE ALSO
Inside Macintosh volumes 1 and 5,
.BR "ppmtopict" (1)\c
\&,
.BR "ppm" (5)\c
\&
.UN author
.SH AUTHOR
Copyright 1993 George Phillips
.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/picttoppm.html
.PP
|
