Debian Codegraph @

upstream/debian-unstable/man1/pammixinterlace.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pammixinterlace User Manual" 1 "22 February 2007" "netpbm documentation"
7
8 .SH NAME
9 pammixinterlace - mix adjacent lines to merge interlaced images
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpammixinterlace\fP
15
16 [\fB-filter=\fP{\fBlinear\fP, \fBfir\fP, \fBffmpeg\fP}]
17
18 [\fB-adaptive\fP]
19
20 [\fIinfile\fP]
21
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBpammixinterlace\fP is meant to operate on an image which is the
31 interlacing of two images, where raster rows 0, 2, 4, etc. are from
32 one image and rows 1, 3, 5, etc. are from another. (See below for
33 why you might expect to encounter such an image).
34 .PP
35 \fBpammixinterlace\fP makes each row of the output a mixture
36 of the corresponding row of the input and its two neighbors. It uses
37 half of the main row and a quarter each of the two neighbor rows.
38 .PP
39 This can be useful if the image is a video capture from an
40 interlaced video source. In that case, each row shows the subject
41 1/60 second before or after the two rows that surround it. If the
42 subject is moving, this can detract from the quality of the image.
43 .PP
44 In video data streams, you often find each frame contains only half
45 the rows of the image -- the odd half or the even half. The displayer
46 of the stream displays the rows in their proper positions on a CRT as
47 they come in. When you display the rows in this order, the CRT has
48 less flicker because a particular area of the screen gets refreshed
49 twice as often. In the process of capturing such a stream, computers
50 often generate the interlaced image of the type that
51 \fBpammixinterlace\fP works with. But this interlaced image, when
52 displayed on a CRT, does not look the same as if a displayer were
53 rendering the stream directly on a CRT as it arrived, because of the
54 timing of when the various pixels get drawn and subsequently fade.
55 That's why you need something like \fBpammixinterlace\fP.
56 .PP
57 You may prefer the effect of simply extracting one of two images.
58 You can do that with \fBpamdeinterlace\fP.
59
60
61 .UN options
62 .SH OPTIONS
63 .PP
64 In addition to the options common to all programs based on libnetpbm
65 (most notably \fB-quiet\fP, see
66 .UR index.html#commonoptions
67 Common Options
68 .UE
69 \&), \fBpammixinterlace\fP recognizes the following
70 command line options:
71
72
73
74 .TP
75 \fB-filter=\fP{\fBlinear\fP,\fBfir\fP,\fBffmpeg\fP}
76 This option chooses between one of the three filtering mechanisms.
77 \fBlinear\fP is a linear-blend formula. \fBfir\fP is a size-5 FIR
78 low-pass filter, and \fBffmpeg\fP is a formula pulled from the
79 documentation of the program
80 .UR http://ffmpeg.mplayerhq.hu
81 \fBffmpeg\fP
82 .UE
83 \&.
84 .sp
85 The default is \fBfir\fP.
86
87 .TP
88 \fB-adaptive\fP
89 This option turns on "adaptive" filtering mode. In this mode
90 \fBpammixinterlace\fP modifies only pixels that are obviously part of
91 a "comb" pattern.
92
93
94
95
96 .UN seealso
97 .SH SEE ALSO
98 .BR "pamdeinterlace" (1)\c
99 \&,
100 .BR "pam" (1)\c
101 \&
102 .BR "pnm" (1)\c
103 \&
104 .SH DOCUMENT SOURCE
105 This manual page was generated by the Netpbm tool 'makeman' from HTML
106 source. The master documentation is at
107 .IP
108 .B http://netpbm.sourceforge.net/doc/pammixinterlace.html
109 .PP