1 files changed, 109 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pammixinterlace.1 b/upstream/mageia-cauldron/man1/pammixinterlace.1
new file mode 100644
index 00000000..706372b5
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pammixinterlace.1
@@ -0,0 +1,109 @@
+\
+.\" 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 "Pammixinterlace User Manual" 0 "22 February 2007" "netpbm documentation"
+
+.SH NAME
+pammixinterlace - mix adjacent lines to merge interlaced images
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpammixinterlace\fP
+
+[\fB-filter=\fP{\fBlinear\fP, \fBfir\fP, \fBffmpeg\fP}]
+
+[\fB-adaptive\fP]
+
+[\fIinfile\fP]
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpammixinterlace\fP is meant to operate on an image which is the
+interlacing of two images, where raster rows 0, 2, 4, etc. are from
+one image and rows 1, 3, 5, etc. are from another.  (See below for
+why you might expect to encounter such an image).
+.PP
+\fBpammixinterlace\fP makes each row of the output a mixture
+of the corresponding row of the input and its two neighbors.  It uses
+half of the main row and a quarter each of the two neighbor rows.
+.PP
+This can be useful if the image is a video capture from an
+interlaced video source.  In that case, each row shows the subject
+1/60 second before or after the two rows that surround it.  If the
+subject is moving, this can detract from the quality of the image.
+.PP
+In video data streams, you often find each frame contains only half
+the rows of the image -- the odd half or the even half.  The displayer
+of the stream displays the rows in their proper positions on a CRT as
+they come in.  When you display the rows in this order, the CRT has
+less flicker because a particular area of the screen gets refreshed
+twice as often.  In the process of capturing such a stream, computers
+often generate the interlaced image of the type that
+\fBpammixinterlace\fP works with.  But this interlaced image, when
+displayed on a CRT, does not look the same as if a displayer were
+rendering the stream directly on a CRT as it arrived, because of the
+timing of when the various pixels get drawn and subsequently fade.
+That's why you need something like \fBpammixinterlace\fP.
+.PP
+You may prefer the effect of simply extracting one of two images.
+You can do that with \fBpamdeinterlace\fP.
+
+
+.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
+\&), \fBpammixinterlace\fP recognizes the following
+command line options:
+
+
+
+.TP
+\fB-filter=\fP{\fBlinear\fP,\fBfir\fP,\fBffmpeg\fP}
+This option chooses between one of the three filtering mechanisms.
+\fBlinear\fP is a linear-blend formula.  \fBfir\fP is a size-5 FIR
+low-pass filter, and \fBffmpeg\fP is a formula pulled from the
+documentation of the program 
+.UR http://ffmpeg.mplayerhq.hu
+\fBffmpeg\fP
+.UE
+\&.
+.sp
+The default is \fBfir\fP.
+
+.TP
+\fB-adaptive\fP
+This option turns on "adaptive" filtering mode.  In this mode
+\fBpammixinterlace\fP modifies only pixels that are obviously part of
+a "comb" pattern.
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamdeinterlace" (1)\c
+\&,
+.BR "pam" (1)\c
+\&
+.BR "pnm" (1)\c
+\&
+.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/pammixinterlace.html
+.PP
+\ No newline at end of file