diff options
Diffstat (limited to 'picttoppm.html')
-rw-r--r-- | picttoppm.html | 175 |
1 files changed, 175 insertions, 0 deletions
diff --git a/picttoppm.html b/picttoppm.html new file mode 100644 index 00000000..67e0d98d --- /dev/null +++ b/picttoppm.html @@ -0,0 +1,175 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Picttoppm User Manual</TITLE></HEAD> +<BODY> +<H1>picttoppm</H1> +Updated: 17 June 2006 +<BR> +<A HREF="#index">Table Of Contents</A> + +<H2>NAME</H2> + +picttoppm - convert a Macintosh PICT file to a PPM + +<H2 id="synopsis">SYNOPSIS</H2> + +<B>picttoppm</B> + +[<B>-verbose</B>] + +[<B>-fullres</B>] + +[<B>-noheader</B>] + +[<B>-quickdraw</B>] + +[<B>-fontdir</B>file<B>]</B> + +[<I>pictfile</I>] + +<H2 id="description">DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>picttoppm</b> reads a PICT file (version 1 or 2) and outputs a PPM +image. + +<p>This is useful as the first step in converting a scanned image to +something that can be displayed on Unix. + +<H2 id="options">OPTIONS</H2> + +<DL COMPACT> +<DT><B>-fontdir </B><I>file</I> + +<DD>Make the list of BDF fonts in <i>file</i> available for use by +<b>picttoppm</b> 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 <b>fontdir</b>. + +<DT><B>-fullres</B> + +<DD>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. + +<DT><B>-noheader</B> + +<DD>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. + +<DT><B>-quickdraw</B> + +<DD>Execute only pure quickdraw operations. In particular, turn off +the interpretation of special PostScript printer operations. + +<DT><B>-verbose</B> + +<DD>Print a whole bunch of information about the PICT file and the +conversion process that only <b>picttoppm</b> hackers really care +about. + +</DL> + +<H2 id="limitations">LIMITATIONS</H2> + +The PICT file format is a general drawing format. <b>picttoppm</b> +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. + +<P>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. + +<h2 id="fonts">FONTS</h2> + +<p>Some of the information in a PICT file is text, with a number +indicating the font in which the text is supposed to rendered. +<b>picttoppm</b> has one built-in font, but you can add others by +directing <b>picttoppm</b> to BDF font files, which you do with font +directory files. + +<p><b>picttoppm</b> automatically uses the file named <b>fontdir</b> +in the current directory, if it exists. You may specify an additional +font directory file with the <b>-fontdir</b> option. + +<P>Obviously the font defintions are strongly related to the +Macintosh. You can find more font numbers and information about fonts +in Macintosh documentation. + +<H3 id="fontdir">FONT DIR FILE FORMAT</H3> + +<p>Each line in the file is either a comment or font information. A +comment begins with <b>#</b>. 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. + +<P>The font number indicates the type face. Here is a list of known +font numbers and their faces. + +<dl> +<dt>0 <dd>Chicago +<dt>1 <dd>application font +<dt>2 <dd>New York +<dt>3 <dd>Geneva +<dt>4 <dd>Monaco +<dt>5 <dd>Venice +<dt>6 <dd>London +<dt>7 <dd>Athens +<dt>8 <dd>San Franciso +<dt>9 <dd>Toronto +<dt>11 <dd>Cairo +<dt>12 <dd>Los Angeles +<dt>20 <dd>Times Roman +<dt>21 <dd>Helvetica +<dt>22 <dd>Courier +<dt>23 <dd>Symbol +<dt>24 <dd>Taliesin +</dl> + +<P>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: + +<dl> +<dt>1 <dd>Boldface +<dt>2 <dd>Italic +<dt>4 <dd>Underlined +<dt>8 <dd>Outlined +<dt>16 <dd>Shadow +<dt>32 <dd>Condensed +<dt>64 <dd>Extended +</dl> + + +<H2 id="seealso">SEE ALSO</H2> + +Inside Macintosh volumes 1 and 5, +<A HREF="ppmtopict.html">ppmtopict</A>, +<A HREF="ppm.html">ppm</A> + + +<H2 id="author">AUTHOR</H2> + +Copyright 1993 George Phillips + +<HR> +<A NAME="index"> </A> +<H2>Table Of Contents</H2> +<UL> +<LI><A HREF="#synopsis">SYNOPSIS</A> +<LI><A HREF="#description">DESCRIPTION</A> +<LI><A HREF="#options">OPTIONS</A> +<LI><A HREF="#limitations">BUGS</A> +<LI><A HREF="#fonts">FONTS</A> +<LI><A HREF="#seealso">SEE ALSO</A> +<LI><A HREF="#author">AUTHOR</A> +</UL> +</BODY> +</HTML> |