Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 180 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man1/ppmrough.1 b/upstream/debian-unstable/man1/ppmrough.1
new file mode 100644
index 00000000..33873748
--- /dev/null
+++ b/upstream/debian-unstable/man1/ppmrough.1
@@ -0,0 +1,180 @@
+\
+.\" 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 "Ppmrough User Manual" 1 "20 August 2023" "netpbm documentation"
+
+.SH NAME
+ppmrough - create PPM image of a single color rectangle with ragged edges on a
+different color background
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmrough\fP
+
+[\fB-left \fP\fIpixels\fP]
+
+[\fB-right \fP\fIpixels\fP]
+
+[\fB-top \fP\fIpixels\fP]
+
+[\fB-bottom \fP\fIpixels\fP]
+
+[\fB-width \fP\fIpixels\fP]
+
+[\fB-height \fP\fIpixels\fP]
+
+[\fB-bg \fP\fIcolorspec\fP]
+
+[\fB-fg \fP\fIcolorspec\fP]
+
+[\fB-var \fP\fIpixels\fP]
+
+[\fB-randomseed \fP\fIseed\fP]
+
+[\fB-verbose\fP]
+.PP
+All options can be abbreviated to their shortest unique prefix.
+You may use two hyphens instead of one.  You may separate an option
+name and its value with white space instead of an equals sign.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmrough\fP generates a PPM image of the specified width and height.
+  The image consists of a rectangle of the specified foreground color
+  surrounded by borders of the specified size and background color, except
+  that the boundary between the foreground rectangle and the borders is
+  ragged.  The ragged effect is random.
+.PP
+\fBppmrough\fP writes the PPM image to Standard Output.
+.PP
+The maxval of the output image is 255 (You can change this with
+\fBpamdepth\fP).
+.PP
+Use the options \fB-left\fP or \fB-right\fP, respectively, to make
+vertical borders, and \fB-top\fP or \fB-bottom\fP, respectively, to generate
+horizontal borders inside the image.  The value of each of these options is
+the minimum width of the border on that edge.  Beyond that minimum, the width
+at any given location on that edge is random, varying along the edge in a
+fractal kind of way.
+
+  
+.PP
+Use the \fB-var\fP option to control the "raggedness" of
+the border.  The lower its value, the smoother the border is.  You
+can initialize the pseudo-random generator with the \fB-init\fP
+option.
+.PP
+You could use \fBppmrough\fP with \fBppmtopgm\fP to create a PGM
+transparency mask and use it to roughen up the edges of another image.
+
+.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
+\&), \fBppmrough\fP recognizes the following
+command line options:
+
+
+
+.TP
+\fB-width=\fP\fIpixels\fP
+This specifies the width of the image in pixels (default: 100).
+
+.TP
+\fB-height=\fP\fIpixels\fP
+This specifies the height of the image in pixels (default: 100).
+
+.TP
+\fB-left=\fP\fIpixels\fP
+.TP
+\fB-right=\fP\fIpixels\fP
+.TP
+\fB-top=\fP\fIpixels\fP
+.TP
+\fB-bottom=\fP\fIpixels\fP
+This option causes the program to create a left, right, top, or bottom
+border, respectively, at least \fIpixels\fP pixels wide, varying randomly
+beyond that.  You may specify any combination of these.
+
+.TP
+\fB-bg=\fP\fIcolorspec\fP
+This is the background color, i.e. the color of the
+borders.  \fIcolorspec\fP is as described for the
+.UR libnetpbm_image.html#colorname
+argument of the \fBpnm_parsecolor()\fP library routine
+.UE
+\&.  Default is black.
+
+.TP
+\fB-fg=\fP\fIcolor\fP
+This specifies the foreground color, i.e. the color of the center of the
+mage -- everything but the borders.  \fIcolorspec\fP is as described for the
+.UR libnetpbm_image.html#colorname
+argument of the \fBpnm_parsecolor()\fP library routine
+.UE
+\&.  Default is white.
+
+.TP
+\fB-var=\fP\fIpixels\fP
+This specifies how ragged the borders are -- how much and how quickly its
+width varies along the image edge.  Its specific meaning is complex, but the
+larger it is, the more the border varies.  Zero means it does not vary at all
+-- the edge of the foreground is straight.
+.sp
+This must be a nonnegative integer.  The default is 10.
+
+.TP
+\fB-randomseed=\fP\fIseed\fP
+Use this option to initialize the pseudo-random number generator
+with \fIseed\fP.
+.sp
+You can use this to cause the program to produce repeatable output.
+.sp
+Before Netpbm 10.61 (December 2012), this is called \fB-init\fP,
+and that still works.
+
+.TP
+\fB-verbose\fP
+Run \fBppmrough\fP in verbose mode.  It reports all parameters on
+Standard Error.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "ppmmake" (1)\c
+\&,
+.BR "pamcat" (1)\c
+\&,
+.BR "ppmtopgm" (1)\c
+\&,
+.BR "ppm" (1)\c
+\&,
+
+.UN history
+.SH HISTORY
+.PP
+This program was added to Netpbm in Release 10.9 (September 2002).
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 2002 by Eckard Specht.
+.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/ppmrough.html
+.PP
\ No newline at end of file