1 files changed, 164 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/ppmbrighten.1 b/upstream/opensuse-leap-15-6/man1/ppmbrighten.1
new file mode 100644
index 00000000..9f81bf19
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/ppmbrighten.1
@@ -0,0 +1,164 @@
+\
+.\" 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 "Ppmbrighten User Manual" 0 "26 October 2012" "netpbm documentation"
+
+.SH NAME
+ppmbrighten - change a PPM image's Saturation and Value
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmbrighten\fP
+[\fB-normalize\fP]
+[\fB-saturation \fP[\fB+\fP|\fB-\fP\fIsaturation_percent\fP]]
+[\fB-value \fP[\fB+\fP|\fB-\fP\fIvalue_percent\fP]]
+\fIppmfile\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
+\fBppmbrighten\fP increases or decreases the Saturation and Value
+(from the HSV color space) of each pixel of a PPM image.  You specify
+the per centage 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
+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 PPM format is 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%), \fBppmbrighten\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%),
+\fBppmbrighten\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 per centage,
+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
+\fBppmbrighten\fP.
+.PP
+\fBppmflash\fP does another kind of brightening.  It changes the
+color of each pixel to bring it a specified per centage closer to white.
+This increases the value and saturation.
+
+.UN examples
+.SH EXAMPLES
+.PP
+To double the Value of each pixel:
+.nf
+ppmbrighten -v 100
+.fi
+.PP
+To double the Saturation and halve the Value of each pixel:
+.nf
+ppmbrighten -s 100 -v -50
+.fi
+
+.UN options
+.SH OPTIONS
+
+
+.TP
+\fB-value \fP\fIvalue_percent\fP
+This option specifies the amount, as a per centage, by which you want
+to change the Value of each pixel.  It may be negative.
+
+.TP
+\fB-saturation \fP\fIvalue_percent\fP
+This option specifies the amount, as a per centage, by which you want
+to change the Saturation of each pixel.  It may be negative.
+
+
+.TP
+\fB-normalize\fP
+This option causes \fBppmbrighten\fP to linearly remap the Values
+of the pixels to cover the range 0 to 1.  The option name is wrong --
+this operation is not normalization (it was named in error and the
+name has been kept for backward compatibility).
+.sp
+\fBppmbrighten\fP applies the brightening that you specify with 
+the \fB-value\fP option \fIafter\fP the remapping.
+.sp
+Before Netpbm 10.14 (March 2003), your input must be from a seekable
+file (not a pipe) to use \fB-normalize\fP.  If it isn't, the program fails
+with a bogus error message.
+
+  
+
+.UN seealso
+.SH SEE ALSO
+.BR "pnmnorm" (1)\c
+\&, 
+.BR "ppmdim" (1)\c
+\&, 
+.BR "pamfunc" (1)\c
+\&, 
+.BR "ppmflash" (1)\c
+\&, 
+.BR "pamdepth" (1)\c
+\&, 
+.BR "pnmgamma" (1)\c
+\&, 
+.BR "ppmhist" (1)\c
+\&, 
+.BR "ppm" (5)\c
+\&
+
+.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/ppmbrighten.html
+.PP
+\ No newline at end of file