Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 188 insertions, 0 deletions

diff --git a/upstream/debian-bookworm/man1/pambrighten.1 b/upstream/debian-bookworm/man1/pambrighten.1
new file mode 100644
index 00000000..b0fc4053
--- /dev/null
+++ b/upstream/debian-bookworm/man1/pambrighten.1
@@ -0,0 +1,188 @@
+\
+.\" 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 "Pambrighten User Manual" 1 "18 August 2020" "netpbm documentation"
+
+.SH NAME
+pambrighten - change a PPM image's Saturation and Value
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpambrighten\fP
+[\fB-saturation=\fP[\fB+\fP|\fB-\fP]\fIsaturation_percent\fP]
+[\fB-value=\fP[\fB+\fP|\fB-\fP]\fIvalue_percent\fP]
+[\fInetpbmfile\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
+\fBpambrighten\fP increases or decreases the Saturation and Value
+(from the HSV color space) of each pixel of a Netpbm image.  You specify
+the percentage change for each of those parameters.
+.PP
+You can also remap the colors of the pixels so their Values cover the full
+range of possible Values.
+.PP
+The input image is from the file named \fInetpbmfile\fP, or Standard
+Input if \fInetpbmfile\fP is not specified.
+  
+.PP
+The output format is the same as the input format and any extra channels,
+such as transparency, are passed through.
+  
+.PP
+Hue-Saturation-Value, or HSV, is one way to represent a color, like the
+more well-known RGB.  Hue, Saturation, and Value are numbers in the range from
+0 to 1.  We always capitalize them in this document when we mean the number
+from the HSV color space, especially since "value" as a conventional English
+word has a much more abstract meaning.
+.PP
+Value is a measure of how bright the color is, relative to some specified
+maximum (the Netpbm formats are also defined in terms of a specified maximum
+brightness -- For the purposes of this program, they are the same).  In
+particular, it is the brightness of the brightest primary color component of
+the color divided by the maximum brightness possible for a component.  Zero
+Value means black.  White has full Value.
+.PP
+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
+Saturation is a measure of how close the color is to the color indicated by
+the Hue and Value.  A lower number means more light of the third primary color
+must be added to get the exact color.  Full Saturation means the color is a
+secondary color.  Zero Saturation means the color is gray (or black or white).
+Decreasing the saturation of a color tends to make it washed out.
+.PP
+If it is impossible to increase the Value of a pixel by the amount you
+specify (e.g. the Value is .5 and you specify +200%), \fBpambrighten\fP
+increases it to full Value instead.
+.PP
+If it is impossible to increase the Saturation of a pixel by the amount
+you specify (e.g. it is already half saturated and you specify +200%),
+\fBpambrighten\fP increases it to full Saturation instead.
+.PP
+For a simpler kind of brightening, you can use \fBpamfunc -multiplier\fP
+simply to increase the brightness of each pixel by a specified percentage,
+clipping each RGB component where the calculated brightness would exceed full
+brightness.  Thus, the brightest colors in the image would change chromaticity
+in addition to not getting the specified brightness boost.  For
+\fIdecreasing\fP brightness, \fBpamfunc\fP should do the same thing as
+\fBpambrighten\fP.
+.PP
+\fBppmflash\fP does another kind of brightening.  It changes the color of
+each pixel to bring it a specified percentage closer to white.  This increases
+the value and saturation.
+.PP
+\fBpambrighten\fP is meant to replace \fBppmbrighten\fP.  It is the same
+as \fBppmbrighten\fP, except that it recognizes the various Netpbm image
+formats rather than treating them all as PPM.  The output format is the same
+as the input format and extra channels in a PAM image (such as a
+transparency channel) get passed through.
+.PP
+If you want to modify the hues in the image, use \fBpamhue\fP.
+
+  
+.UN examples
+.SH EXAMPLES
+.PP
+To double the Value of each pixel:
+.nf
+pambrighten -value=100
+
+.fi
+.PP
+To double the Saturation and halve the Value of each pixel:
+.nf
+pambrighten -saturation=+100 -value=-50
+
+.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
+\&), \fBpambrighten\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-value=\fP\fIvalue_percent\fP
+This option specifies the amount, as a percentage, by which you want to
+increase the Value of each pixel.  It may be negative.
+.sp
+The default is zero.
+  
+.TP
+\fB-saturation=\fP\fIvalue_percent\fP
+This option specifies the amount, as a percentage, by which you want to
+increase the Saturation of each pixel.  It may be negative.
+.sp
+The default is zero.
+
+  
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmnorm" (1)\c
+\&, 
+.BR "ppmdim" (1)\c
+\&, 
+.BR "pamfunc" (1)\c
+\&, 
+.BR "ppmflash" (1)\c
+\&, 
+.BR "pamaltsat" (1)\c
+\&, 
+.BR "pamdepth" (1)\c
+\&, 
+.BR "pnmgamma" (1)\c
+\&, 
+.BR "pamhue" (1)\c
+\&, 
+.BR "ppmhist" (1)\c
+\&, 
+.BR "ppm" (1)\c
+\&
+
+.UN history
+.SH HISTORY
+.PP
+\fBpambrighten\fP was new in Netphm 10.86 (March 2019).  It was a PAM
+conversion of the much older \fBppmbrighten\fP.
+  
+
+.UN author
+.SH AUTHOR
+.PP
+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/pambrighten.html
+.PP
\ No newline at end of file