| 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 |