.TH pnmtogif 1 "30 June 1993"
.IX pnmtogif
.SH NAME
pnmtogif - convert a portable anymap into a GIF file
.SH SYNOPSIS
.B pnmtogif
.RB [ -interlace ]
.RB [ -sort ]
.RB [ -map
.IR mapfile ]
.RB [ -transparent
.IR color ]
.RI [ pnmfile ]
.SH DESCRIPTION
Reads a portable anymap as input.
Produces a GIF file as output.
.IX GIF
.SH OPTIONS
.TP
.B -interlace
Tells the program to produce an interlaced GIF file.
.TP
.B -sort
Produces a GIF file with a sorted color map.
.TP
.B -map 
Uses the colors found in the
.I mapfile
to create the colormap in the GIF file, instead of the colors from
.I pnmfile.
The
.I mapfile
can be any
.I pnm
file; all that matters is the colors in it. If the colors in
.I ppmfile
do not match those in
.I mapfile
, they are matched to a "best match". A (much) better result can be obtained by
using the following filter in advance:
.I ppmquant
-floyd -map
.I mapfile
.TP
.B -transparent
Mark the given color as transparent in the GIF file.  The color is specified
as in
.IR ppmmake (1).
Note that this option outputs a GIF89a format file which might not be
understood by your software.
.PP
All flags may be abbreviated to their shortest unique prefix.
.SH "SEE ALSO"
giftopnm(1), ppmquant(1), ppm(5)
.SH AUTHOR
Based on GIFENCOD by David Rowley <mgardi@watdcsu.waterloo.edu>.
Lempel-Ziv compression based on "compress".

Copyright (C) 1989 by Jef Poskanzer.
.\" Permission to use, copy, modify, and distribute this software and its
.\" documentation for any purpose and without fee is hereby granted, provided
.\" that the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.  This software is provided "as is" without express or
.\" implied warranty.
.\"
.\" The Graphics Interchange Format(c) is the Copyright property of
.\" CompuServe Incorporated.  GIF(sm) is a Service Mark property of
.\" CompuServe Incorporated.