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. Use-
    ful 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 con-
    tained 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 particular, turn off
    the interpretation of special PostScript printer operations.

    -verbose
    Turns on verbose mode which prints a a whole bunch of informa-
    tion that only picttoppm hackers really care about.

BUGS
    The PICT file format is a general drawing format. picttoppm does not
    support all the drawing commands, but it does have full support for any
    image commands and reasonable support for line, rectangle, polgon and
    text drawing. It is useful for converting scanned images and some
    drawing 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 con-
    taining 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. Multiple variations
    may apply to a font and the font style is the sum of the variation num-
    bers 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