summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-40/man1/pamhue.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-40/man1/pamhue.1')
-rw-r--r--upstream/fedora-40/man1/pamhue.1125
1 files changed, 125 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/pamhue.1 b/upstream/fedora-40/man1/pamhue.1
new file mode 100644
index 00000000..ff2146c7
--- /dev/null
+++ b/upstream/fedora-40/man1/pamhue.1
@@ -0,0 +1,125 @@
+\
+.\" 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 "Pamhue User Manual" 0 "07 January 2018" "netpbm documentation"
+
+.SH NAME
+pamhue - change a Netpbm image's hues
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamhue\fP
+[\fB-huechange=\fP[\fIdegrees\fP]]
+\fIfilename\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
+\fBpamhue\fP shifts the hue of every pixel in an image by the same amount.
+.PP
+If the image is in a black and white or grayscale format, the image is
+fully desaturated, so the hue is meaningless and \fBpamhue\fP leaves the
+image unchanged.
+.PP
+Hue-Saturation-Value, or HSV, is one way to represent a color, like the
+more well-known RGB. Hue is an indication of the secondary color with the
+same brightness that most closely approximates the color. A secondary color
+is made of a combination of at most two of the primary colors.
+.PP
+In the HSV model, hue is an angular position on the color wheel.
+.PP
+With \fBpamhue\fP, you indicate an angle by which to change all the hues
+in the image; for example you can say move it 60 degrees clockwise. That
+would change all red pixels to yellow and all yellow pixels to green, etc.
+
+.PP
+To modify the saturation and value components of the colors, use
+\fBpambrighten\fP.
+
+
+.UN examples
+.SH EXAMPLES
+.PP
+To shift the color of each pixel 120 degrees clockwise:
+.nf
+pamhue -huechange=120
+
+.fi
+.PP
+To shift the color of each pixel 120 degrees counterclockwise:
+.nf
+pamhue -huechange=-120
+
+.fi
+
+
+.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
+\&), \fBpamhue\fP recognizes the following
+command line option:
+
+
+.TP
+\fB-huechange=\fP\fIdegrees\fP
+This option specifies the amount to shift each color. It is in degrees,
+with positive meaning clockwise and negative meaning counterclockwise. It may
+be fractional and may be more than a full revolution.
+.sp
+This option is mandatory.
+
+
+
+.UN history
+.SH HISTORY
+.PP
+\fBpamhue\fP was new in Netpbm 10.86 (March 2019).
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pambrighten" (1)\c
+\&,
+.BR "ppmflash" (1)\c
+\&,
+.BR "ppmhist" (1)\c
+\&,
+.BR "ppm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+.PP
+Copyright (C) 2018 by Willem van Schaik.
+Copyright (C) 1990 by Brian Moffet.
+Copyright (C) 1989 by Jef Poskanzer.
+.PP
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted, provided
+that the above copyright notice appear in all copies and that both that
+copyright notice and this permission notice appear in supporting
+documentation. This software is provided "as is" without express or
+implied warranty.
+.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/pamhue.html
+.PP \ No newline at end of file