Debian Codegraph @

upstream/debian-unstable/man1/ppmdist.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmdist User Manual" 1 "22 July 1992" "netpbm documentation"
7
8 .SH NAME
9
10 ppmdist - simplistic grayscale assignment for machine generated, color images
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBppmdist\fP
16
17 [\fB-intensity\fP|\fB-frequency\fP]
18
19 [\fIppmfile\fP]
20
21 .UN description
22 .SH DESCRIPTION
23 .PP
24 This program is part of
25 .BR "Netpbm" (1)\c
26 \&.
27 .PP
28 \fBppmdist\fP reads a PPM image as input and performs a simplistic
29 grayscale assignment intended for use with grayscale or bitmap
30 printers.
31 .PP
32 Often conversion from ppm to pgm will yield an image with contrast
33 too low for good printer output. The program maximizes contrast
34 between the gray levels output.
35 .PP
36 A ppm input of n colors is read, and a pgm of n gray levels is
37 written. The gray levels take on the values 0..n-1, while maxval
38 takes on n-1.
39 .PP
40 The mapping from color to stepped grayscale can be performed in
41 order of input pixel intensity, or input pixel frequency (number of
42 repetitions).
43 .PP
44 This program is helpful only for images with a very small number of
45 colors.
46
47 .UN options
48 .SH OPTIONS
49 .PP
50 In addition to the options common to all programs based on libnetpbm
51 (most notably \fB-quiet\fP, see
52 .UR index.html#commonoptions
53 Common Options
54 .UE
55 \&), \fBppmdist\fP recognizes the following
56 command line options:
57
58
59 .TP
60 \fB-frequency\fP
61 Sort input colors by the number of times a color appears in the
62 input, before mapping to evenly distributed graylevels of output.
63
64 .TP
65 \fB-intensity\fP
66 Sort input colors by their grayscale intensity, before mapping to
67 evenly distributed graylevels of output. This is the default.
68
69
70
71 .UN seealso
72 .SH SEE ALSO
73 .BR "ppmtopgm" (1)\c
74 \&,
75 .BR "ppmhist" (1)\c
76 \&,
77 .BR "ppm" (1)\c
78 \&
79
80 .UN author
81 .SH AUTHOR
82
83 Copyright (C) 1993 by Dan Stromberg.
84 .SH DOCUMENT SOURCE
85 This manual page was generated by the Netpbm tool 'makeman' from HTML
86 source. The master documentation is at
87 .IP
88 .B http://netpbm.sourceforge.net/doc/ppmdist.html
89 .PP