summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/pamgradient.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/mageia-cauldron/man1/pamgradient.1')
-rw-r--r--upstream/mageia-cauldron/man1/pamgradient.1115
1 files changed, 115 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pamgradient.1 b/upstream/mageia-cauldron/man1/pamgradient.1
new file mode 100644
index 00000000..a7e5a5b6
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pamgradient.1
@@ -0,0 +1,115 @@
+\
+.\" 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 "Pamgradient User Manual" 0 "21 October 2005" "netpbm documentation"
+
+.SH NAME
+pamgradient - create a four-corner gradient PAM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamgradient\fP
+[\fB-maxval=\fP\fImaxval\fP]
+\fIcolor-tl\fP \fIcolor-tr\fP \fIcolor-bl\fP \fIcolor-br\fP
+\fIwidth\fP \fIheight\fP
+.PP
+Minimum unique abbreviation of option is acceptable. You may use double
+hyphens instead of single hyphen to denote options. You may use white
+space in place of the equals sign to separate an option name from its value.
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamgradient\fP creates an image of the specified
+dimensions \fIwidth\fP by \fIheight\fP which contains a smooth,
+two-dimensional gradient between the specified colors of the four
+corners (from top left to bottom right).
+.PP
+Specify the colors as described for the
+.UR libnetpbm_image.html#colorname
+argument of the \fBpnm_parsecolor()\fP library routine
+.UE
+\&.
+.PP
+If all four colors are gray values, \fBpamgradient\fP creates a
+grayscale image (PAM tuple type GRAYSCALE). Otherwise, it creates
+a color image (PAM tuple type RGB).
+
+.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
+\&), \fBpamgradient\fP recognizes the following
+command line option:
+
+
+.TP
+\fB-maxval=\fP\fImaxval\fP
+
+
+maxval of the generated image. (See
+.BR "PAM" (1)\c
+\& and
+.BR "PNM" (1)\c
+\& specifications).
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "\fBpamgradient\fP" (1)\c
+\&,
+.BR "\fBppmmake\fP" (1)\c
+\&,
+.BR "\fBppmrainbow\fP" (1)\c
+\&,
+.BR "\fBpgmramp\fP" (1)\c
+\&,
+.BR "\fBppmpat\fP" (1)\c
+\&,
+.BR "pam" (1)\c
+\&,
+.BR "pnm" (1)\c
+\&
+
+.UN note
+.SH NOTE
+.PP
+Only the top left corner of the generated image has exactly
+the specified color. The color of the top right corner is a bit
+shifted to the left, the bottom left corner a bit up, and the
+bottom right corner left and up. This ensures nice transitions
+when combining adjacent (very narrow) gradients, and doesn't play
+a role when the gradient butts against a solid surface.
+.PP
+This effect is created by the integer arithmetic used for the
+interpolation of the color values, and since it doesn't make a
+difference for all practical purposes I might as well sell it as a
+feature.
+
+.UN history
+.SH HISTORY
+.PP
+\fBpamgradient\fP was new in Netpbm 10.31 (December 2005).
+
+.UN author
+.SH AUTHOR
+.PP
+pamgradient was written by Daniel Haude in October 2005.
+.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/pamgradient.html
+.PP \ No newline at end of file