.TL
Ppmdist User Manual
.SH 1
ppmdist
.LP
Updated: 22 July 1992
.br
Table Of Contents
.SH 2
NAME
.LP
ppmdist - simplistic grayscale assignment for machine generated, color images
.SH 2
SYNOPSIS
.LP
\fBppmdist\fR
[\fB-intensity\fR|\fB-frequency\fR]
[\fIppmfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBppmdist\fR reads a PPM image as input and performs a simplistic
grayscale assignment intended for use with grayscale or bitmap
printers.
.LP
Often conversion from ppm to pgm will yield an image with contrast
too low for good printer output.  The program maximizes contrast
between the gray levels output.
.LP
A ppm input of n colors is read, and a pgm of n gray levels is
written.  The gray levels take on the values 0..n-1, while maxval
takes on n-1.
.LP
The mapping from color to stepped grayscale can be performed in
order of input pixel intensity, or input pixel frequency (number of
repetitions).
.LP
This program is helpful only for images with a very small number of
colors.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-frequency\fR"
Sort input colors by the number of times a color appears in the
input, before mapping to evenly distributed graylevels of output.
.IP "\fB-intensity\fR"
Sort input colors by their grayscale intensity, before mapping to
evenly distributed graylevels of output.  This is the default.
.RE
.SH 2
SEE ALSO
.LP
ppmtopgm,
ppmhist,
ppm
.SH 2
AUTHOR
.LP
Copyright (C) 1993 by Dan Stromberg.
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP