Manual: picttoppm

Picttoppm User Manual(1)			   General Commands Manual			    Picttoppm User Manual(1)

NAME
       picttoppm - convert a Macintosh PICT file to a PPM

SYNOPSIS
       picttoppm

       [-verbose=n]

       [-fullres]

       [-noheader]

       [-quickdraw] [-fontdir file]

       [pictfile]

DESCRIPTION
       This program is part of Netpbm(1).

       picttoppm reads a PICT file (version 1 or 2) and outputs a PPM image.

       PICT  is an image format that was developed by Apple Computer in 1984 as the native format for Macintosh graphics.  A
       PICT image is encoded in QuickDraw commands.  The PICT format is a meta-format that can be used for both	 bitmap	 im‐
       ages and vector images.	PICT is also known as "Macintosh Picture" format, or the QuickDraw Picture format.

       PICT files are primarily used to exchange graphics between various Macintosh applications.

       In MacOS X, PDF replaces PICT as the main graphics format.

OPTIONS
       In  addition  to	 the  options common to all programs based on libnetpbm (most notably -quiet, see  Common Options ),
       picttoppm recognizes the following command line 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.  This is in addition to the built-in fonts and those in the file fontdir.

       -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.  This option disables all PICT operations except images.

       -noheader
	      Do not assume the first 512 bytes of the file are a header.  All PICT files have such a header,  but  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=n
	      Print a whole bunch of information about the PICT file and the conversion process that only picttoppm  hackers
	      really care about.

	      n is the verbosity level, 0-2.

	      Before  Netpbm 10.98 (March 2022), this option is a flag option that you specify multiple times to specify in‐
	      creasing verbosity.

LIMITATIONS
       The PICT file format is a general drawing format.  picttoppm does not recognize all the drawing commands, but it does
       fully implement all image commands and mostly implements line, rectangle, polygon and text drawing.  It is useful for
       converting scanned images and some drawing conversion.

       With -fullres, picttoppm ignores text drawing commands.	Beginning in Netpbm 10.45 (December 2008), it issues a warn‐
       ing message when it omits text for this reason.

FONTS
       Some of the information in a PICT file is text, with a number indicating the font in which the text  is	supposed  to
       rendered.   picttoppm  has  one built-in font, but you can add others by directing picttoppm to BDF font files, which
       you do with font directory files.

       picttoppm automatically uses the file named fontdir in the current directory, if it exists.  You may specify an addi‐
       tional font directory file with the -fontdir option.

       Obviously the font definitions are strongly related to the Macintosh.  You can find more font numbers and information
       about fonts in Macintosh documentation.

   Font Directory File Format
       Each line in the file is either a comment or font information.  A comment begins with #.	 The font  information	con‐
       sists  of  4  whitespace	 separated 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.

       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 numbers which are:

       1      Boldface

       2      Italic

       4      Underlined

       8      Outlined

       16     Shadow

       32     Condensed

       64     Extended

SEE ALSO
       Inside Macintosh volumes 1 and 5, ppmtopict(1), ppm(1)

AUTHOR
       Copyright 1993 George Phillips

DOCUMENT SOURCE
       This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

	      http://netpbm.sourceforge.net/doc/picttoppm.html

netpbm documentation					17 June 2006				    Picttoppm User Manual(1)