picttoppm(1)                                         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

                         29 November 1991                       1