.TL
Picttoppm User Manual
.SH 1
picttoppm
.LP
Updated: 17 June 2006
.br
Table Of Contents
.SH 2
NAME
.LP
picttoppm - convert a Macintosh PICT file to a PPM
.SH 2
SYNOPSIS
.LP
\fBpicttoppm\fR
[\fB-verbose\fR]
[\fB-fullres\fR]
[\fB-noheader\fR]
[\fB-quickdraw\fR]
[\fB-fontdir\fRfile\fB]\fR
[\fIpictfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpicttoppm\fR reads a PICT file (version 1 or 2) and outputs a PPM
image.
.LP
This is useful as the first step in converting a scanned image to
something that can be displayed on Unix.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-fontdir \fR\fIfile\fR"
Make the list of BDF fonts in \fIfile\fR available for use by
\fBpicttoppm\fR 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\fR.
.IP "\fB-fullres\fR"
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.
.IP "\fB-noheader\fR"
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.
.IP "\fB-quickdraw\fR"
Execute only pure quickdraw operations.  In particular, turn off
the interpretation of special PostScript printer operations.
.IP "\fB-verbose\fR"
Print a whole bunch of information about the PICT file and the
conversion process that only \fBpicttoppm\fR hackers really care
about.
.RE
.SH 2
LIMITATIONS
.LP
The PICT file format is a general drawing format.  \fBpicttoppm\fR
does not recognize all the drawing commands, but it does fully
implement all image commands and mostly implement line, rectangle,
polgon and text drawing.  It is useful for converting scanned images
and some drawing conversion.
.LP
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.
.SH 2
FONTS
.LP
.LP
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\fR has one built-in font, but you can add others by
directing \fBpicttoppm\fR to BDF font files, which you do with font
directory files.
.LP
\fBpicttoppm\fR automatically uses the file named \fBfontdir\fR
in the current directory, if it exists.  You may specify an additional
font directory file with the \fB-fontdir\fR option.
.LP
Obviously the font defintions are strongly related to the
Macintosh.  You can find more font numbers and information about fonts
in Macintosh documentation.
.SH 3
FONT DIR FILE FORMAT
.LP
.LP
Each line in the file is either a comment or font information.  A
comment begins with \fB#\fR.  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 beyond the scope of this document.
.LP
The font number indicates the type face.  Here is a list of known
font numbers and their faces.
.RS
.IP "0       Chicago"
.IP "1       application font"
.IP "2       New York"
.IP "3       Geneva"
.IP "4       Monaco"
.IP "5       Venice"
.IP "6       London"
.IP "7       Athens"
.IP "8       San Franciso"
.IP "9       Toronto"
.IP "11      Cairo"
.IP "12      Los Angeles"
.IP "20      Times Roman"
.IP "21      Helvetica"
.IP "22      Courier"
.IP "23      Symbol"
.IP "24      Taliesin"
.RE
.LP
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:
.RS
.IP "1       Boldface"
.IP "2       Italic"
.IP "4       Underlined"
.IP "8       Outlined"
.IP "16      Shadow"
.IP "32      Condensed"
.IP "64      Extended"
.RE
.SH 2
SEE ALSO
.LP
Inside Macintosh volumes 1 and 5,
ppmtopict,
ppm
.SH 2
AUTHOR
.LP
Copyright 1993 George Phillips
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
BUGS
.IP \(bu
FONTS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP