Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 208 insertions, 0 deletions

diff --git a/upstream/fedora-rawhide/man1/pamsistoaglyph.1 b/upstream/fedora-rawhide/man1/pamsistoaglyph.1
new file mode 100644
index 00000000..68b5986e
--- /dev/null
+++ b/upstream/fedora-rawhide/man1/pamsistoaglyph.1
@@ -0,0 +1,208 @@
+\
+.\" 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 "Pamsistoaglyph User Manual" 0 "05 April 2009" "netpbm documentation"
+
+.SH NAME
+
+pamsistoaglyph - convert a single-image stereogram to a red/cyan
+anaglyphic image
+
+
+.UN synopsis
+.SH SYNOPSIS
+.PP
+\fBpamsistoaglyph\fP
+[--\fBinvert\fP]
+[--\fBsep\fP=\fInumber\fP]
+[--\fBminsep\fP=\fInumber\fP]
+[--\fBgray\fP=\fInumber\fP]
+[\fIin_netpbmfile\fP
+.PP
+All options can be abbreviated to their shortest unique prefix. You
+may use either white space or an equals sign between an option name
+and its value.
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamsistoaglyph\fP reads a Netpbm image as input and
+produces a Netpbm image as output.
+.PP
+\fBpamsistoaglyph\fP takes a single-image stereogram
+(SIS) such as those produced by
+.BR "pamstereogram" (1)\c
+\&
+and converts it to a red/cyan anaglyphic image such as those produced
+by
+.BR "ppm3d" (1)\c
+\&.
+Many people have trouble tricking their eyes into focusing beyond the
+image in front of them and are therefore unable to perceive the 3-D
+shape hidden within a single-image stereogram.  Anaglyphic stereograms
+are easier to perceive in 3-D but require a pair of red/cyan glasses
+such as those often used to watch 3-D movies. The goal of
+\fBpamsistoaglyph\fP is to help people who have trouble
+viewing single-image stereograms see the intriguing 3-D effect.
+.PP
+\fBpamsistoaglyph\fP can convert single-image random-dot
+stereograms (SIRDS), wallpaper stereograms, and even dual-image
+stereograms to anaglyphic images.
+
+
+.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
+\&), \fBpamsistoaglyph\fP recognizes the following
+command line options:
+.PP
+For most images, no command-line options need to be specified.  The
+following options are available, however, for unusual circumstances.
+
+
+.TP
+\fB--invert\fP
+Swap the left- and right-eye
+    images. \fBpamsistoaglyph\fP assumes that its input
+    represents a wall-eyed stereogram and generates the anaglyphic
+    image accordingly. If the generated image appears to recede into
+    the page where it should pop out of the page (and vice versa),
+    this typically implies that the input image represents a
+    cross-eyed stereogram. Use \fB--invert\fP to correct
+    the image depth.
+
+.TP
+\fB--sep\fP=\fInumber\fP
+Specify the distance in pixels between the left- and right-eye
+    images. Essentially, this corresponds to the distance between
+    repetitions of the background pattern.  The \fB--sep\fP
+    option should rarely be necessary
+    as \fBpamsistoaglyph\fP is fairly good at determining
+    automatically the eye-separation distance.
+
+.TP
+\fB--minsep\fP=\fInumber\fP
+This option is similar to \fB--sep\fP but
+    constrains \fBpamsistoaglyph\fP only to
+    a \fIminimum\fP eye-separation distance. Any distance larger
+    than \fInumber\fP is acceptable.  The \fB--minsep\fP
+    option should rarely be necessary
+    as \fBpamsistoaglyph\fP is fairly good at determining
+    automatically the eye-separation distance.  The default value for
+    the minimum eye-separation distance is 10% of the image width;
+    this value seems to work well in practice.
+
+.TP
+\fB--gray\fP=\fInumber\fP
+Limit the number of gray levels to use when searching for the
+    optimal eye-separation
+    distance.  Because \fBpamsistoaglyph\fP looks for
+    repeated patterns, it is vulnerable to being confused by slight
+    variations in color.  By reducing the input image to grayscale and
+    capping the number of gray levels,
+    \fBpamsistoaglyph\fP ameliorates the effects of
+    unintentional color variations (such as those caused by conversion
+    from a low-quality JPEG image, for example). The default of 63
+    seems to work well so the \fB--gray\fP option should
+    rarely be necessary.
+
+
+
+.UN notes
+.SH NOTES
+.PP
+The registration algorithm used by \fBpamsistoaglyph\fP
+was developed specifically for this program. As far as the author
+knows, there are no existing algorithms for converting stereograms to
+anaglyphs.  The algorithm works as follows:
+
+
+.IP \(bu
+Convert the image to grayscale to increase the ability to identify
+    matches.
+
+.IP \(bu
+Count the number of pixels that match \fIN\fP pixels ahead in the
+    image for all \fIN\fP in [1, \fIwidth\fP/2].
+
+.IP \(bu
+Maintain a running mean (mu) and standard deviation (sigma) of
+    the number of matched pixels.
+
+.IP \(bu
+Store the \fIN\fP corresponding to each spike in the number of
+    matched pixels. A spike is defined as a tally that exceeds the
+    mean plus one, two, or three standard deviations. Only the first
+    spike of a given standard-deviation multiplier is stored.
+
+.IP \(bu
+If a tally greater than mu+3sigma was encountered, return the
+    corresponding \fIN\fP. If not, then if a tally greater than
+    mu+2sigma was encountered, return the
+    corresponding \fIN\fP. If not, then if a tally greater than
+    mu+sigma was encountered, return the
+    corresponding \fIN\fP. If not, then return the \fIN\fP that
+    produces the minimum average distance between matched pixels
+    (i.e.,\ \fI#matches\fP divided by \fI#pixels\fP). If no
+    such \fIN\fP exceeds the minimum allowable eye-separation value,
+    return zero to indicate failure.
+
+.IP \(bu
+If the algorithm returned zero, rerun the algorithm independently
+    on each row of the input image and return the median of
+    all \fIN\fP that exceed the minimum allowable eye-separation
+    value. If no such \fIN\fP exists, abort with an error
+    message.
+
+
+.UN history
+.SH HISTORY
+.PP
+Scott Pakin wrote \fBpamsistoaglyph\fP in April 2009.  It first appeared
+in Netpbm in Release 10.47 (June 2009).
+
+
+.UN author
+.SH AUTHOR
+.PP
+Copyright (C) 2009 Scott
+Pakin, \fIscott+pbm@pakin.org\fP
+
+
+.UN seealso
+.SH SEE ALSO
+
+
+
+.IP \(bu
+
+.BR "pamstereogram" (1)\c
+\&
+.IP \(bu
+
+.BR "ppm3d" (1)\c
+\&,
+.IP \(bu
+
+.UR http://en.wikipedia.org/wiki/Stereogram
+http://en.wikipedia.org/wiki/Stereogram
+.UE
+\&
+.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/pamsistoaglyph.html
+.PP
\ No newline at end of file