Debian Codegraph @

upstream/debian-unstable/man1/picttoppm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Picttoppm User Manual" 1 "17 June 2006" "netpbm documentation"
7
8 .SH NAME
9 picttoppm - convert a Macintosh PICT file to a PPM
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpicttoppm\fP
15
16 [\fB-verbose=\fP\fIn\fP]
17
18 [\fB-fullres\fP]
19
20 [\fB-noheader\fP]
21
22 [\fB-quickdraw\fP]
23 [\fB-fontdir\fP \fIfile\fP]
24
25 [\fIpictfile\fP]
26
27 .UN description
28 .SH DESCRIPTION
29 .PP
30 This program is part of
31 .BR "Netpbm" (1)\c
32 \&.
33 .PP
34 \fBpicttoppm\fP reads a PICT file (version 1 or 2) and outputs a PPM
35 image.
36 .PP
37 PICT is an image format that was developed by Apple Computer in 1984 as the
38 native format for Macintosh graphics. A PICT image is encoded in QuickDraw
39 commands. The PICT format is a meta-format that can be used for both bitmap
40 images and vector images. PICT is also known as "Macintosh Picture"
41 format, or the QuickDraw Picture format.
42 .PP
43 PICT files are primarily used to exchange graphics between various
44 Macintosh applications.
45 .PP
46 In MacOS X, PDF replaces PICT as the main graphics format.
47
48 .UN options
49 .SH OPTIONS
50 .PP
51 In addition to the options common to all programs based on libnetpbm
52 (most notably \fB-quiet\fP, see
53 .UR index.html#commonoptions
54 Common Options
55 .UE
56 \&), \fBpicttoppm\fP recognizes the following
57 command line options:
58
59
60 .TP
61 \fB-fontdir \fP\fIfile\fP
62 Make the list of BDF fonts in \fIfile\fP available for use by
63 \fBpicttoppm\fP when drawing text. See below for the format of the
64 fontdir file. This is in addition to the built-in fonts and those in
65 the file \fBfontdir\fP.
66
67 .TP
68 \fB-fullres\fP
69 Force any images in the PICT file to be output with at least their
70 full resolution. A PICT file may indicate that a contained
71 image is to be scaled down before output. This option forces images
72 to retain their sizes and prevent information loss.
73 This option disables all PICT operations except images.
74
75 .TP
76 \fB-noheader\fP
77 Do not assume the first 512 bytes of the file are a header. All PICT
78 files have such a header, but this is useful when you have PICT data that was
79 not stored in the data fork of a PICT file.
80
81 .TP
82 \fB-quickdraw\fP
83 Execute only pure quickdraw operations. In particular, turn off
84 the interpretation of special PostScript printer operations.
85
86 .TP
87 \fB-verbose=\fP\fIn\fP
88 Print a whole bunch of information about the PICT file and the conversion
89 process that only \fBpicttoppm\fP hackers really care about.
90 .sp
91 \fIn\fP is the verbosity level, 0-2.
92 .sp
93 Before Netpbm 10.98 (March 2022), this option is a flag option that you
94 specify multiple times to specify increasing verbosity.
95
96
97
98 .UN limitations
99 .SH LIMITATIONS
100
101 The PICT file format is a general drawing format. \fBpicttoppm\fP
102 does not recognize all the drawing commands, but it does fully
103 implement all image commands and mostly implements line, rectangle,
104 polygon and text drawing. It is useful for converting scanned images
105 and some drawing conversion.
106 .PP
107 With \fB-fullres\fP, \fBpicttoppm\fP ignores text drawing commands.
108 Beginning in Netpbm 10.45 (December 2008), it issues a warning message
109 when it omits text for this reason.
110
111 .UN fonts
112 .SH FONTS
113 .PP
114 Some of the information in a PICT file is text, with a number
115 indicating the font in which the text is supposed to rendered.
116 \fBpicttoppm\fP has one built-in font, but you can add others by
117 directing \fBpicttoppm\fP to BDF font files, which you do with font
118 directory files.
119 .PP
120 \fBpicttoppm\fP automatically uses the file named \fBfontdir\fP
121 in the current directory, if it exists. You may specify an additional
122 font directory file with the \fB-fontdir\fP option.
123 .PP
124 Obviously the font definitions are strongly related to the
125 Macintosh. You can find more font numbers and information about fonts
126 in Macintosh documentation.
127
128 .UN fontdir
129 .SS Font Directory File Format
130 .PP
131 Each line in the file is either a comment or font information. A
132 comment begins with \fB#\fP. The font information consists of 4
133 whitespace separated fields. The first is the font number, the second
134 is the font size in pixels, the third is the font style and the fourth
135 is the name of a BDF file containing the font. The BDF format is
136 defined by the X Window System and is beyond the scope of this document.
137 .PP
138 The font number indicates the type face. Here is a list of known
139 font numbers and their faces.
140
141
142 .TP
143 0
144 Chicago
145 .TP
146 1
147 application font
148 .TP
149 2
150 New York
151 .TP
152 3
153 Geneva
154 .TP
155 4
156 Monaco
157 .TP
158 5
159 Venice
160 .TP
161 6
162 London
163 .TP
164 7
165 Athens
166 .TP
167 8
168 San Franciso
169 .TP
170 9
171 Toronto
172 .TP
173 11
174 Cairo
175 .TP
176 12
177 Los Angeles
178 .TP
179 20
180 Times Roman
181 .TP
182 21
183 Helvetica
184 .TP
185 22
186 Courier
187 .TP
188 23
189 Symbol
190 .TP
191 24
192 Taliesin
193
194 .PP
195 The font style indicates a variation on the font. Multiple
196 variations may apply to a font and the font style is the sum of the
197 variation numbers which are:
198
199
200 .TP
201 1
202 Boldface
203 .TP
204 2
205 Italic
206 .TP
207 4
208 Underlined
209 .TP
210 8
211 Outlined
212 .TP
213 16
214 Shadow
215 .TP
216 32
217 Condensed
218 .TP
219 64
220 Extended
221
222
223
224 .UN seealso
225 .SH SEE ALSO
226
227 Inside Macintosh volumes 1 and 5,
228 .BR "ppmtopict" (1)\c
229 \&,
230 .BR "ppm" (1)\c
231 \&
232
233
234 .UN author
235 .SH AUTHOR
236
237 Copyright 1993 George Phillips
238 .SH DOCUMENT SOURCE
239 This manual page was generated by the Netpbm tool 'makeman' from HTML
240 source. The master documentation is at
241 .IP
242 .B http://netpbm.sourceforge.net/doc/picttoppm.html
243 .PP