picttoppm(1)
NAME
picttoppm - convert a Macintosh PICT file into a portable
pixmap
SYNOPSIS
picttoppm [-verbose] [-fullres] [-noheader] [-quickdraw]
[-fontdirfile] [pictfile]
DESCRIPTION
Reads a PICT file (version 1 or 2) and outputs a portable
pixmap. Useful as the first step in converting a scanned
image to something that can be displayed on Unix.
OPTIONS
- -fontdir file
- Make the list of BDF fonts in ``file'' available
for use by picttoppm when drawing text. See below for the format of the fontdir file. - -fullres
- 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.
Use of this option disables all PICT operations
except images. - -noheader
- Do not skip the 512 byte header that is present on
all PICT files. This is useful when you have PICT
data that was not stored in the data fork of a PICT
file. - -quickdraw
- Execute only pure quickdraw operations. In partic
ular, turn off the interpretation of special
PostScript printer operations. - -verbose
- Turns on verbose mode which prints a a whole bunch
of information that only picttoppm hackers really care about.
BUGS
The PICT file format is a general drawing format. pict_
toppm does not support all the drawing commands, but it
does have full support for any image commands and reason
able support for line, rectangle, polgon and text drawing.
It is useful for converting scanned images and some draw
ing conversion.
Memory is used very liberally with at least 6 bytes needed
for every pixel. Large bitmap PICT files will likely run
your computer out of memory.
FONT DIR FILE FORMAT
picttoppm has a built in default font and your local
installer probably provided adequate extra fonts. You can
point picttoppm at more fonts which you specify in a font
directory file. Each line in the file is either a comment
line which must begin with ``#'' or font information. The
font information consists of 4 whitespace spearated
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 not
described here.
The font number indicates the type face. Here is a list
of known font numbers and their faces.
0 Chicago
1 application font
2 New York
3 Geneva
4 Monaco
5 Venice
6 London
7 Athens
8 San Franciso
9 Toronto
11 Cairo
12 Los Angeles
20 Times Roman
21 Helvetica
22 Courier
23 Symbol
24 Taliesin
The font style indicates a variation on the font. Multi
ple variations may apply to a font and the font style is
the sum of the variation numbers which are:
1 Boldface
2 Italic
4 Underlined
8 Outlined
16 Shadow
32 Condensed
64 Extended
Obviously the font defintions are strongly related to the
Macintosh. More font numbers and information about fonts
can be found in Macintosh documentation.
SEE ALSO
Inside Macintosh volumes 1 and 5, ppmtopict(1), ppm(5)
AUTHOR
- Copyright 1993 George Phillips