.TH ppmtomap 1 "11 August 1993"
.IX ppmtomap
.SH NAME
ppmtomap - extract all colors from a portable pixmap
.SH SYNOPSIS
.B ppmtomap
.RB [ -sort ]
.RB [ -square ]
.RI [ ppmfile ]
.SH DESCRIPTION
Reads a portable pixmap as input.
Produces a portable pixmap as output, representing a color map of the
input file. All N different colors found are put in an Nx1 portable
pixmap.
This color map file can be used as a mapfile for
.I ppmquant
or
.I ppmtogif.
.SH OPTIONS
.TP
.B -sort
Produces a portable pixmap with the colors in some sorted order.
.TP
.B -square
Produces a (more or less) square output file, instead of putting all
colors on the top row.
.PP
All flags can be abbreviated to their shortest unique prefix.
.SH WARNING
If you want to use the output file as a mapfile for
.I ppmtogif,
you first have to do a
.I ppmquant 256,
since
.I ppmtomap
is not limited to 256 colors (but to 65536).
.SH "SEE ALSO"
ppmtogif(1), ppmquant(1), ppm(5)
.SH AUTHOR
Marcel Wijkstra (wijkstra@fwi.uva.nl).

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.