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

                               29 November 1991                   picttoppm(1)