\
.\" 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" (5)\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