diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/pgmramp.1')
-rw-r--r-- | upstream/mageia-cauldron/man1/pgmramp.1 | 139 |
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 |