Debian Codegraph @

upstream/debian-unstable/man1/pgmramp.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 "Pgmramp User Manual" 1 "15 February 2014" "netpbm documentation"
7
8 .SH NAME
9
10 pgmramp - generate a grayscale ramp
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpgmramp\fP
16 {\fB-lr\fP|\fB-tb\fP|\fB-rectangle\fP|\fB-ellipse\fP|\fB-diagonal\fP}
17 [\fB-maxval=\fP\fImaxval\fP]
18 \fIwidth\fP \fIheight\fP
19 .PP
20 All options can be abbreviated to their shortest unique prefix.
21 You may use two hyphens instead of one to designate an option. You
22 may use either white space or an equals sign between an option name
23 and its value.
24
25 .UN description
26 .SH DESCRIPTION
27 .PP
28 This program is part of
29 .BR "Netpbm" (1)\c
30 \&.
31 .PP
32 Generates a graymap of the specified size containing a
33 black-to-white ramp. These ramps are useful for multiplying with
34 other images, using \fBpamarith\fP.
35 .PP
36 The ramp is linear in brightness, not intensity. I.e. the
37 gamma-corrected sample values in the PGM rise linearly with distance
38 from the corner of the image. If you want a ramp that is linear in
39 light intensity, use \fBpnmgamma\fP with \fBpgmramp\fP.
40 .PP
41 Options let you choose the shape of the ramp (left to right, inside
42 out, etc.). You can use \fBpamflip\fP to get more shapes. For
43 example, the \fB-lr\fP option gives you a left to right ramp and
44
45 .nf
46 \f(CW
47 $ pgmramp -lr 100 100 | pamflip -lr
48 \fP
49
50 .fi
51
52 gives you a right to left ramp.
53 .PP
54 To generate a simple ramp of all the values from 0 to maxval, and not
55 necessarily a graphic image, use
56 .BR "pamseq" (1)\c
57 \&.
58 .PP
59 \fBppmrainbow\fP does something similar to what \fBpgmramp\fP does,
60 but for color. The image fades between two colors of your choice.
61
62
63 .UN options
64 .SH OPTIONS
65 .PP
66 In addition to the options common to all programs based on libnetpbm
67 (most notably \fB-quiet\fP, see
68 .UR index.html#commonoptions
69 Common Options
70 .UE
71 \&), \fBpgmramp\fP recognizes the following
72 command line options:
73 .PP
74 You must specify exactly one of the ramp type options.
75
76
77 .TP
78 \fB-lr\fP
79 A left to right ramp. Black on the left; white on the right.
80
81 .TP
82 \fB-tb\fP
83 A top to bottom ramp. Black on top; white on the bottom.
84
85 .TP
86 \fB-rectangle\fP
87 An outside-in rectangular ramp. It is black around the edges and white
88 in the center.
89
90 .TP
91 \fB-ellipse\fP
92 An outside-in elliptical ramp. It is black around the edge and white
93 in the center.
94
95 .TP
96 \fB-diagonal\fP
97 A ramp from top left corner diagonally down to bottom right. Black at
98 the top left; white at the bottom right.
99 .sp
100 This option was new in Netpbm 10.66 (March 2014).
101
102 .TP
103 \fB-maxval=\fP\fImaxval\fP
104 The maxval for the generated image. Default is 255.
105 .sp
106 This option was new in Netpbm 10.1 (June 2002). Before that, the maxval
107 is always 255.
108
109
110
111
112 .UN seealso
113 .SH SEE ALSO
114 .BR "\fBpamflip\fP" (1)\c
115 \&,
116 .BR "\fBpamarith\fP" (1)\c
117 \&,
118 .BR "\fBpnmgamma\fP" (1)\c
119 \&,
120 .BR "\fBpamseq\fP" (1)\c
121 \&,
122 .BR "\fBppmrainbow\fP" (1)\c
123 \&,
124 .BR "\fBpamgradient\fP" (1)\c
125 \&,
126 .BR "pgm" (1)\c
127 \&
128
129
130 .UN author
131 .SH AUTHOR
132
133 Copyright (C) 1989 by Jef Poskanzer.
134 .SH DOCUMENT SOURCE
135 This manual page was generated by the Netpbm tool 'makeman' from HTML
136 source. The master documentation is at
137 .IP
138 .B http://netpbm.sourceforge.net/doc/pgmramp.html
139 .PP