summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/pgmramp.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/mageia-cauldron/man1/pgmramp.1')
-rw-r--r--upstream/mageia-cauldron/man1/pgmramp.1139
1 files changed, 139 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pgmramp.1 b/upstream/mageia-cauldron/man1/pgmramp.1
new file mode 100644
index 00000000..9fd1b8bc
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pgmramp.1
@@ -0,0 +1,139 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it! If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Pgmramp User Manual" 0 "15 February 2014" "netpbm documentation"
+
+.SH NAME
+
+pgmramp - generate a grayscale ramp
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpgmramp\fP
+{\fB-lr\fP|\fB-tb\fP|\fB-rectangle\fP|\fB-ellipse\fP|\fB-diagonal\fP}
+[\fB-maxval=\fP\fImaxval\fP]
+\fIwidth\fP \fIheight\fP
+.PP
+All options can be abbreviated to their shortest unique prefix.
+You may use two hyphens instead of one to designate an option. You
+may use either white space or an equals sign between an option name
+and its value.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+Generates a graymap of the specified size containing a
+black-to-white ramp. These ramps are useful for multiplying with
+other images, using \fBpamarith\fP.
+.PP
+The ramp is linear in brightness, not intensity. I.e. the
+gamma-corrected sample values in the PGM rise linearly with distance
+from the corner of the image. If you want a ramp that is linear in
+light intensity, use \fBpnmgamma\fP with \fBpgmramp\fP.
+.PP
+Options let you choose the shape of the ramp (left to right, inside
+out, etc.). You can use \fBpamflip\fP to get more shapes. For
+example, the \fB-lr\fP option gives you a left to right ramp and
+
+.nf
+\f(CW
+ $ pgmramp -lr 100 100 | pamflip -lr
+\fP
+
+.fi
+
+gives you a right to left ramp.
+.PP
+To generate a simple ramp of all the values from 0 to maxval, and not
+necessarily a graphic image, use
+.BR "pamseq" (1)\c
+\&.
+.PP
+\fBppmrainbow\fP does something similar to what \fBpgmramp\fP does,
+but for color. The image fades between two colors of your choice.
+
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-quiet\fP, see
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBpgmramp\fP recognizes the following
+command line options:
+.PP
+You must specify exactly one of the ramp type options.
+
+
+.TP
+\fB-lr\fP
+A left to right ramp. Black on the left; white on the right.
+
+.TP
+\fB-tb\fP
+A top to bottom ramp. Black on top; white on the bottom.
+
+.TP
+\fB-rectangle\fP
+An outside-in rectangular ramp. It is black around the edges and white
+in the center.
+
+.TP
+\fB-ellipse\fP
+An outside-in elliptical ramp. It is black around the edge and white
+in the center.
+
+.TP
+\fB-diagonal\fP
+A ramp from top left corner diagonally down to bottom right. Black at
+the top left; white at the bottom right.
+.sp
+This option was new in Netpbm 10.66 (March 2014).
+
+.TP
+\fB-maxval=\fP\fImaxval\fP
+ The maxval for the generated image. Default is 255.
+.sp
+ This option was new in Netpbm 10.1 (June 2002). Before that, the maxval
+ is always 255.
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "\fBpamflip\fP" (1)\c
+\&,
+.BR "\fBpamarith\fP" (1)\c
+\&,
+.BR "\fBpnmgamma\fP" (1)\c
+\&,
+.BR "\fBpamseq\fP" (1)\c
+\&,
+.BR "\fBppmrainbow\fP" (1)\c
+\&,
+.BR "\fBpamgradient\fP" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&
+
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1989 by Jef Poskanzer.
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source. The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/pgmramp.html
+.PP \ No newline at end of file