summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/pammixinterlace.1
blob: 706372b562b555beaccd3001af4a989c40bb36fc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
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