annotate DOCS/man/en/mplayer.1 @ 14298:3c818342a02b

Add -ao pcm suboptions and remove -aofile and -waveheader options. Base on idea by Olivier Rolland (billl at users dot sf dot net)
author reimar
date Sun, 02 Jan 2005 14:41:47 +0000
parents 0126a2f79310
children 32e8aa98601f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
11137
7e1c06614147 Revision keyword added.
diego
parents: 11131
diff changeset
1 .\" $Revision$
11796
f4305ab15f4f Time to bump the dates, filter configuration file example, .TH expanded.
diego
parents: 11782
diff changeset
2 .\" MPlayer (C) 2000-2004 MPlayer Team
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
3 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
4 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6 .\" Macro definitions
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
8 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
9 .\" default indentation is 7, don't change!
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
10 .nr IN 7
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
11 .\" define indentation for suboptions
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
12 .nr SS 5
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
13 .\" add new suboption
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
14 .de IPs
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
15 .IP "\\$1" \n(SS
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
16 ..
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
17 .\" begin of first level suboptions, end with .RE
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
18 .de RSs
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
19 .RS \n(IN+3
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
20 ..
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
21 .\" begin of 2nd level suboptions
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
22 .de RSss
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
23 .PD 0
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
24 .RS \n(SS+3
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
25 ..
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
26 .\" end of 2nd level suboptions
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
27 .de REss
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
28 .RE
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
29 .PD 1
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
30 ..
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
31 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
32 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
33 .\" Title
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
34 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
35 .
14069
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
36 .TH MPlayer 1 "2004-11-30" "The MPlayer Project" "The Movie Player"
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
37 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
38 .SH NAME
12645
3841ef14a481 name change
diego
parents: 12621
diff changeset
39 mplayer \- movie player
3841ef14a481 name change
diego
parents: 12621
diff changeset
40 .br
3841ef14a481 name change
diego
parents: 12621
diff changeset
41 mencoder \- movie encoder
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
42 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
43 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
44 .\" Synopsis
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
45 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
46 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
47 .SH SYNOPSIS
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
48 .na
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
49 .nh
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
50 .B mplayer
11115
10972fd355bf stdin should also be \-, forgotten \.
diego
parents: 11103
diff changeset
51 .RI [options]\ [ \ file\ | \ URL\ | \ playlist\ | \ \-\ ]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
52 .
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
53 .br
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
54 .in
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
55 .B mplayer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
56 'in +\n[.k]u
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
57 [global options]
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
58 .I file1
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
59 [specific options] [file2] [specific options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
60 .
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
61 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
62 .in
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
63 .B mplayer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
64 'in +\n[.k]u
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
65 [global options]
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
66 .RI { "group of files and options" }
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
67 [group specific options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
68 .
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
69 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
70 .in
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
71 .B mplayer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
72 'in +\n[.k]u
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
73 .I dvd://[title | [start_title]\-end_title ]
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
74 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
75 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
76 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
77 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
78 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
79 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
80 .I vcd://track[/device]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
81 .
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
82 .br
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
83 .in
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
84 .B mplayer
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
85 'in +\n[.k]u
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
86 .I tv://[channel]
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
87 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
88 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
89 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
90 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
91 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
92 'in +\n[.k]u
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
93 .I dvb://[card_number@]channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
94 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
95 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
96 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
97 .in
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
98 .B mplayer
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
99 'in +\n[.k]u
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
100 .I mf://filemask
12402
b0f31de74374 Hint at -mf in mf:// syntax description.
diego
parents: 12389
diff changeset
101 [-mf options] [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
102 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
103 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
104 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
105 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
106 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
107 .I [cdda|cddb]://track[:speed][/device]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
108 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
109 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
110 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
111 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
112 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
113 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
114 .I cue://file[:track]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
115 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
116 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
117 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
118 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
119 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
120 'in +\n[.k]u
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
121 .RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] ://
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
122 [user:passwd@]\fIURL\fP[:port] [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
123 .
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
124 .br
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
125 .in
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
126 .B mplayer
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
127 'in +\n[.k]u
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
128 .I sdp://file
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
129 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
130 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
131 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
132 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
133 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
134 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
135 .I mpst://host[:port]/URL
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
136 [options]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
137 .
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
138 .br
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
139 .in
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
140 .B gmplayer
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
141 [options]
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
142 [\-skin\ skin]
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
143 .
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
144 .br
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
145 .B mencoder
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
146 [options]
11115
10972fd355bf stdin should also be \-, forgotten \.
diego
parents: 11103
diff changeset
147 .RI [ \ file\ | \ URL\ | \ \-\ ]
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
148 [\-o\ file]
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
149 .ad
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
150 .hy
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
151 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
152 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
153 .\" Description
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
154 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
155 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
156 .SH DESCRIPTION
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
157 .B mplayer
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
158 is a movie player for Linux (runs on many other platforms and CPU
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
159 architectures, see the documentation).
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
160 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM,
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
161 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
162 native and binary codecs.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
163 You can watch VideoCD, SVCD, DVD, 3ivx, DivX\ 3/\:4/\:5 and even WMV movies,
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
164 too.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
165 .PP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
166 MPlayer supports a wide range of video and audio output drivers.
12216
d4e2bdc246a3 -vo caca documentation, patch by Pigeon <pigeon@pigeond.net>
diego
parents: 12199
diff changeset
167 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
d4e2bdc246a3 -vo caca documentation, patch by Pigeon <pigeon@pigeond.net>
diego
parents: 12199
diff changeset
168 Quartz, but you can also use GGI, SDL (and all their drivers), VESA (on every
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
169 VESA-compatible card, even without X11), some low-level card-specific drivers
12216
d4e2bdc246a3 -vo caca documentation, patch by Pigeon <pigeon@pigeond.net>
diego
parents: 12199
diff changeset
170 (for Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards, such as the
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
171 Siemens DVB, DXR2 and DXR3/\:Hollywood+.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
172 Most of them support software or hardware scaling, so you can enjoy movies in
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
173 fullscreen mode.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
174 .PP
6573
7663637ddba4 OSD == onscreen display, typos
diego
parents: 6469
diff changeset
175 MPlayer has an onscreen display (OSD) for status information, nice big
7663637ddba4 OSD == onscreen display, typos
diego
parents: 6469
diff changeset
176 antialiased shaded subtitles and visual feedback for keyboard controls.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
177 European/\:ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
12823
6026e1e566f7 Number of subtitles corrected.
diego
parents: 12816
diff changeset
178 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
11873
9c66ef56b1b1 Fix the PJS (aka dunnowhat) subtitles
attila
parents: 11858
diff changeset
179 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
180 DVD subtitles (SPU streams, VOBsub and Closed Captions).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
181 .PP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
182 .B mencoder
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
183 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
184 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
185 below).
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
186 It encodes to MPEG-4 (DivX/XviD), one of the libavcodec codecs and
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
187 PCM/\:MP3/\:VBRMP3 audio in 1, 2 or 3\ passes.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
188 Furthermore it has stream copying abilities, a powerful filter system (crop,
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
189 expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
190 more.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
191 .PP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
192 .B gmplayer
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
193 is MPlayer with a graphical user interface.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
194 It has the same options as MPlayer.
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
195 .PP
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
196 Usage examples to get you started quickly can be found at the end
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
197 of this man page.
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
198 .PP
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
199 .B Also see the HTML documentation!
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
200 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
201 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
202 .\" --------------------------------------------------------------------------
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
203 .\" Keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
204 .\" --------------------------------------------------------------------------
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
205 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
206 .SH "KEYBOARD CONTROL"
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
207 MPlayer has a fully configurable, command-driven control layer
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
208 which allows you to control MPlayer using keyboard, mouse, joystick
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
209 or remote control (with LIRC).
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
210 See the \-input option for ways to customize it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
211 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
212 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
213 .B general control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
214 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
215 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
216 .IPs "<\- and \->"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
217 Seek backward/\:forward 10 seconds.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
218 .IPs "up and down"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
219 Seek backward/\:forward 1 minute.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
220 .IPs "pgup and pgdown"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
221 Seek backward/\:forward 10 minutes.
13710
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
222 .IPs "[ and ]"
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
223 Decreases/increases current playback speed by 10%.
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
224 .IPs "{ and }"
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
225 Halves/doubles current playback speed.
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
226 .IPs "Backspace"
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
227 Reset playback speed to normal.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
228 .IPs "< and >"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
229 backward/\:forward in playlist
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
230 .IPs "HOME and END"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
231 next/\:previous playtree entry in the parent list
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
232 .IPs "INS and DEL"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
233 next/\:previous alternative source (ASX playlist only)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
234 .IPs "p / SPACE"
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
235 Pause movie (pressing again unpauses).
13726
da328456c758 small fixes
diego
parents: 13725
diff changeset
236 .IPs .\ \ \ \
13626
741649fe31cb allow to step only one frame forward by pressing s.
reimar
parents: 13613
diff changeset
237 Step forward.
741649fe31cb allow to step only one frame forward by pressing s.
reimar
parents: 13613
diff changeset
238 Pressing once will pause movie, every consecutive press will play one frame
741649fe31cb allow to step only one frame forward by pressing s.
reimar
parents: 13613
diff changeset
239 and then go into pause mode again (any other key unpauses).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
240 .IPs "q / ESC"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
241 Stop playing and quit.
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
242 .IPs "+ and -"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
243 Adjust audio delay by +/\:- 0.1 seconds.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
244 .IPs "/ and *"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
245 Decrease/\:increase volume.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
246 .IPs "9 and 0"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
247 Decrease/\:increase volume.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
248 .IPs m\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
249 Mute sound.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
250 .IPs f\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
251 Toggle fullscreen (also see \-fs).
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
252 .IPs T\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
253 Toggle stay-on-top (also see \-ontop).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
254 .IPs "w and e"
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
255 Decrease/\:increase pan-and-scan range.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
256 .IPs o\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
257 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
258 .IPs d\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
259 Toggle frame dropping states: none / skip display / skip decoding
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
260 (see \-framedrop and \-hardframedrop).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
261 .IPs v\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
262 Toggle subtitle visibility.
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
263 .IPs "b / j"
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
264 Cycle through the available subtitles.
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
265 .IP F\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
266 Toggle displaying "forced subtitles".
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
267 .IPs a\ \ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
268 Toggle subtitle aligment: top/\:middle/\:bottom.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
269 .IPs "z and x"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
270 Adjust subtitle delay by +/\:- 0.1 seconds.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
271 .IPs "r and t"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
272 Move subtitles up/\:down.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
273 .IPs i\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
274 Set EDL mark.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
275 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
276 .PD 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
277 .PP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
278 (The following keys are valid only when using a hardware accelerated video
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
279 output (xv, (x)vidix, (x)mga, etc), or the software equalizer filter
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
280 (\-vf eq or \-vf eq2).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
281 .PP
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
282 .PD 0
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
283 .RSs
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
284 .IPs "1 and 2"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
285 Adjust contrast.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
286 .IPs "3 and 4"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
287 Adjust brightness.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
288 .IPs "5 and 6"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
289 Adjust hue.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
290 .IPs "7 and 8"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
291 Adjust saturation.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
292 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
293 .PD 1
13725
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
294 .PP
13726
da328456c758 small fixes
diego
parents: 13725
diff changeset
295 (The following keys are valid only when using the quartz video output driver.)
13725
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
296 .PP
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
297 .PD 0
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
298 .RSs
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
299 .IPs "option + 0"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
300 Resize movie window to half its original size.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
301 .IPs "option + 1"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
302 Resize movie window to its original size.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
303 .IPs "option + 2"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
304 Resize movie window to double its original size.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
305 .IPs "option + f"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
306 Toggle fullscreen (also see \-fs).
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
307 .IPs "option + [ and option + ]"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
308 Set movie window alpha.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
309 .IPs T\ \ \ \
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
310 Toggle video layer: ontop/below/normal (also see \-ontop).
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
311 .RE
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
312 .PD 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
313 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
314 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
315 .B GUI keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
316 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
317 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
318 .IPs ENTER
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
319 Start playing.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
320 .IPs s\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
321 Stop playing.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
322 .IPs l\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
323 Load file.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
324 .IPs c\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
325 Skin browser.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
326 .IPs p\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
327 Toggle playlist.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
328 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
329 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
330 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
331 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
332 .B TV input control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
333 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
334 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
335 .IPs "h and k"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
336 Select previous/\:next channel.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
337 .IPs n\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
338 Change norm.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
339 .IPs u\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
340 Change channel list.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
341 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
342 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
343 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
344 .
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
345 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
346 .\" Options
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
347 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
348 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
349 .SH "USAGE"
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
350 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
351 \-fs option is \-nofs.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
352 .PP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
353 If an option is marked as (XXX only), it will only work in combination with
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
354 the XXX option or if XXX is compiled in.
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
355 .PP
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
356 You can put all of the options in a configuration file which will be read
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
357 every time MPlayer is run.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
358 The system-wide configuration file 'mplayer.conf' is in your configuration
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
359 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
360 specific one is '~/\:.mplayer/\:config'.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
361 User specific options override system-wide options and options given on the
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
362 command line override either.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
363 The syntax of the configuration files is 'option=<value>', everything after
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
364 a '#' is considered a comment.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
365 Options that work without values can be enabled by setting them to 'yes'
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
366 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
367 Even suboptions can be specified in this way.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
368 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
369 .I EXAMPLE:
13159
edeba26483a1 simplification
diego
parents: 13158
diff changeset
370 .nf
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
371 # Use Matrox driver by default.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
372 vo=xmga
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
373 # I love practicing handstands while watching videos.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
374 flip=yes
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
375 # Decode/\:encode multiple files from png,
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
376 # start with mf://filemask
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
377 mf=type=png:fps=25
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
378 # Eerie negative images are cool.
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
379 vf=eq2=1.0:-0.8
13159
edeba26483a1 simplification
diego
parents: 13158
diff changeset
380 .fi
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
381 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
382 You can also write file-specific configuration files.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
383 If you wish to have a configuration file for a file called 'movie.avi', create a file
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
384 named 'movie.avi.conf' with the file-specific options in it and put it in
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
385 ~/.mplayer or in the same directory as the file.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
386 .
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
387 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
388 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
389 .SH "GENERAL OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
390 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
391 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
392 .B \-codecs-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
393 Use the specified file instead of system wide installed or builtin codecs.conf.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
394 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
395 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
396 .B \-include <configuration\ file>
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
397 Specify configuration file to be parsed after the default ones.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
398 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
399 .TP
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
400 .B \-quiet\ \
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
401 Make console output less verbose; in particular, prevents the status line
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
402 (i.e.\& A: 0.7 V: 0.6 A-V: 0.068 ...) from being displayed.
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
403 Particularly useful on slow terminals or broken ones which do not properly
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
404 handle carriage return (i.e.\& \\r).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
405 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
406 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
407 .B \-v, \-verbose
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
408 Increment verbose level (more \-v means more verbosity).
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
409 .PD 0
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
410 .RSs
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
411 .IPs 0
11949
86da102d74d8 slight wording improvement, noticed by Dominik
diego
parents: 11943
diff changeset
412 only some informational output (default)
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
413 .IPs 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
414 some basic debug infos, avi header, function values (init debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
415 .IPs 2
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
416 print avi indexes, chunk inputs, more debug infos (player debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
417 .IPs 3
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
418 prints everything related to input parsers (parser debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
419 .RE
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
420 .PD 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
421 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
422 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
423 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
424 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
425 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
426 .TP
11448
gabucino
parents: 11446
diff changeset
427 .B \-autoq <quality> (use with \-vf [s]pp)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
428 Dynamically changes the level of postprocessing depending on the available spare
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
429 CPU time.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
430 The number you specify will be the maximum level used.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
431 Usually you can use some big number.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
432 You have to use \-vf [s]pp without parameters in order for this to work.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
433 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
434 .TP
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
435 .B \-autosync <factor>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
436 Gradually adjusts the A/\:V sync based on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
437 Specifying \-autosync\ 0, the default, will cause frame timing to be based
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
438 entirely on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
439 Specifying \-autosync\ 1 will do the same, but will subtly change the A/\:V
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
440 correction algorithm.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
441 An uneven video framerate in a movie which plays fine with \-nosound can
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
442 often be helped by setting this to an integer value greater than 1.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
443 The higher the value, the closer the timing will be to \-nosound.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
444 Try \-autosync\ 30 to smooth out problems with sound drivers which do
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
445 not implement a perfect audio delay measurement.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
446 With this value, if large A/\:V sync offsets occur, they will only take about
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
447 1 or 2\ seconds to settle out.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
448 This delay in reaction time to sudden A/\:V offsets should be the only
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
449 side-effect of turning this option on, for all sound drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
450 .
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
451 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
452 .B \-benchmark
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
453 Prints some statistics on CPU usage and dropped frames at the end of playback.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
454 Use in combination with \-nosound and \-vo null for benchmarking only the
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
455 video codec.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
456 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
457 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
458 With this option MPlayer will also ignore frame duration when playing
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
459 only video (you can think of that as infinite fps).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
460 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
461 .TP
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
462 .B \-colorkey <number>
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
463 Changes the colorkey to an RGB value of your choice.
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
464 0x000000 is black and 0xffffff is white.
14205
87148f636da2 added colorkey support for vo_directx.
joey
parents: 14199
diff changeset
465 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
14234
b085c4d81b4b small improvements
diego
parents: 14217
diff changeset
466 xover and directx video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
467 .
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
468 .TP
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
469 .B \-nocolorkey
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
470 Disables colorkeying.
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
471 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
14234
b085c4d81b4b small improvements
diego
parents: 14217
diff changeset
472 xover video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
473 .
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
474 .TP
13794
fb83e23e94ce Allow attaching gdb on crash automatically.
reimar
parents: 13790
diff changeset
475 .B \-crash-debug (DEBUG CODE)
fb83e23e94ce Allow attaching gdb on crash automatically.
reimar
parents: 13790
diff changeset
476 Automatically attaches gdb upon crash or SIGTRAP.
fb83e23e94ce Allow attaching gdb on crash automatically.
reimar
parents: 13790
diff changeset
477 Support must be compiled in by configuring with --enable-crash-debug or
fb83e23e94ce Allow attaching gdb on crash automatically.
reimar
parents: 13790
diff changeset
478 by having a .developer file in the source tree.
fb83e23e94ce Allow attaching gdb on crash automatically.
reimar
parents: 13790
diff changeset
479 .
fb83e23e94ce Allow attaching gdb on crash automatically.
reimar
parents: 13790
diff changeset
480 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
481 .B \-edl <filename> (EDL only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
482 Enables edit decision list (EDL) actions during playback.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
483 Video will be skipped over and audio will be muted and unmuted according to
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
484 the entries in the given file.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
485 See DOCS/\:HTML/\:en/\:edl.html for details on how to use this.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
486 .
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
487 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
488 .B \-edlout <filename> (EDL only)
8552
37dd9f68ab71 - and -use-stdin documented, EDL updates.
diego
parents: 8541
diff changeset
489 Creates a new file and writes edit decision list (EDL) records to that file.
37dd9f68ab71 - and -use-stdin documented, EDL updates.
diego
parents: 8541
diff changeset
490 During playback, when the user hits 'i', an entry to skip over the last two
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
491 seconds of playback will be written to the file.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
492 This provides a starting point from which the user can fine-tune EDL entries
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
493 later.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
494 See DOCS/\:HTML/\:en/\:edl.html for details.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
495 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
496 .TP
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
497 .B \-enqueue (GUI only)
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
498 Enqueue files given on the command line in the playlist instead of playing them
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
499 immediately.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
500 .
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
501 .TP
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
502 .B \-fixed-vo (BETA CODE!)
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
503 Enforces a fixed video system for multiple files (one (un)initialisation for
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
504 all files).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
505 Therefore only one window will be opened for all files.
13844
a609c6d5dc3b vo_gl should work fine with -fixed-vo
reimar
parents: 13797
diff changeset
506 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
13029
e0d566eae34a dfbmga now fixed-vo compliant, lavc exports field flags.
diego
parents: 13021
diff changeset
507 xmga, xv, xvidix and dfbmga.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
508 .
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
509 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
510 .B \-framedrop (also see \-hardframedrop)
9269
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
511 Skip displaying some frames to maintain A/\:V sync on slow systems.
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
512 Video filters are not applied to such frames.
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
513 For B-frames even decoding is skipped completely.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
514 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
515 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
516 .B \-h, \-help, \-\-help
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
517 Show short summary of options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
518 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
519 .TP
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
520 .B \-hardframedrop
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
521 More intense frame dropping (breaks decoding).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
522 Leads to image distortion!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
523 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
524 .TP
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
525 .B \-identify
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
526 Show file parameters in an easily parseable format.
14070
e12adb1555e4 -identify now prints subtitle/audio track information.
diego
parents: 14069
diff changeset
527 Also prints more detailed information about subtitle and audio
e12adb1555e4 -identify now prints subtitle/audio track information.
diego
parents: 14069
diff changeset
528 track languages and IDs.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
529 The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
530 (hopefully) shellescapes the filenames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
531 .
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
532 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
533 .B \-input <commands>
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
534 This option can be used to configure certain parts of the input system.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
535 Paths are relative to ~/\:.mplayer/.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
536 .br
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
537 .I NOTE:
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
538 Autorepeat is currently only supported by joysticks.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
539 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
540 Available commands are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
541 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
542 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
543 .RSs
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
544 .IPs conf=<filename>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
545 Specify input configuration file other than the default
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
546 ~/\:.mplayer/\:input.conf.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
547 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
548 .IPs ar-delay
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
549 Delay in msec before we start to autorepeat a key (0 to disable).
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
550 .IPs ar-rate
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
551 Number of key presses to generate per second on autorepeat.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
552 .IPs keylist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
553 Prints all keys that can be bound to commands.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
554 .IPs cmdlist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
555 Prints all commands that can be bound to keys.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
556 .IPs js-dev
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
557 Specifies the joystick device to use (default: /dev/\:input/\:js0).
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
558 .IPs file\
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
559 Read commands from the given file.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
560 Mostly useful with a FIFO.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
561 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
562 .I NOTE:
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
563 When the given file is a FIFO MPlayer opens both ends so you can do
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
564 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
565 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
566 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
567 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
568 .TP
14077
3d3f3cc8494a use a configurable-size ringbuffer instead of a pipe for buffering key events.
reimar
parents: 14076
diff changeset
569 .B \-key-fifo-size <2\-65000>
3d3f3cc8494a use a configurable-size ringbuffer instead of a pipe for buffering key events.
reimar
parents: 14076
diff changeset
570 Specify the size of the FIFO that buffers key events (default: 10).
14079
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
571 A FIFO of size n can buffer (n-1) events.
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
572 If it is too small some events may be lost
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
573 (leading to "stuck mouse buttons" and similar effects).
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
574 If it is too big, MPlayer may seem to hang while it
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
575 processes the buffered events.
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
576 To get the same behaviour as before this option was introduced,
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
577 set it to 2 for Linux or 1024 for Windows.
14077
3d3f3cc8494a use a configurable-size ringbuffer instead of a pipe for buffering key events.
reimar
parents: 14076
diff changeset
578 .
3d3f3cc8494a use a configurable-size ringbuffer instead of a pipe for buffering key events.
reimar
parents: 14076
diff changeset
579 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
580 .B \-lircconf <filename> (LIRC only)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
581 Specifies a configuration file for LIRC (default: ~/\:.lircrc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
582 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
583 .TP
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
584 .B \-list-options
14234
b085c4d81b4b small improvements
diego
parents: 14217
diff changeset
585 Prints all available options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
586 .
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
587 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
588 .B \-loop <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
589 Loops movie playback <number> times.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
590 0 means forever.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
591 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
592 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
593 .B \-menu (OSD menu only)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
594 Turn on OSD menu support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
595 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
596 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
597 .B \-menu-cfg <filename> (OSD menu only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
598 Use an alternative menu.conf.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
599 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
600 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
601 .B \-menu-root <value> (OSD menu only)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
602 Specify the main menu.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
603 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
604 .TP
13368
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
605 .B \-menu-startup (OSD menu only)
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
606 Display the main menu at MPlayer startup.
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
607 .
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
608 .TP
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
609 .B \-noconsolecontrols
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
610 Prevent MPlayer from reading key events from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
611 Useful when reading data from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
612 This is automatically enabled when \- is found on the command line.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
613 There are situations where you have to set it manually, e.g.\&
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
614 if you open /dev/\:stdin (or the equivalent on your system), use stdin
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
615 in a playlist or intend to read from stdin later on via the loadfile or
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
616 loadlist slave commands.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
617 .
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
618 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
619 .B \-nojoystick
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
620 Turns off joystick support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
621 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
622 .TP
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
623 .B \-nolirc
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
624 Turns off LIRC support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
625 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
626 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
627 .B \-nomouseinput (X11 only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
628 Disable mouse button press/\:release input (mozplayerxp's context menu relies
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
629 on this option).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
630 .
10761
040c2011aace fixing alphabetic order
gabucino
parents: 10760
diff changeset
631 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
632 .B \-nortc (RTC only)
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
633 Turns off usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
634 mechanism.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
635 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
636 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
637 .B \-playlist <filename>
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
638 Play files according to a playlist file (ASX, Winamp, SMIL, or
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
639 one-file-per-line format).
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
640 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
641 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
642 This option is considered an entry so options found after it will apply
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
643 only to the elements of this playlist.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
644 .br
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
645 FIXME: This needs to be clarified and documented thoroughly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
646 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
647 .TP
12715
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
648 .B \-really-quiet (also see \-quiet)
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
649 Display even less output and status messages than with \-quiet.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
650 .
8234
ebf9a61bb88c -really-quiet documented
diego
parents: 8221
diff changeset
651 .TP
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
652 .B \-rtc-device <device>
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
653 Use the specified device for RTC timing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
654 .
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
655 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
656 .B \-shuffle
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
657 Play files in random order.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
658 .
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
659 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
660 .B \-skin <name> (GUI only)
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
661 Loads a skin from the directory given as parameter below the default skin
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
662 directories, /usr/\:local/\:share/\:mplayer/\:Skin/\: and ~/.mplayer/\:Skin/.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
663 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
664 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
665 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
666 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
667 .IPs "\-skin fittyfene"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
668 Tries /usr/\:local/\:share/\:mplayer/\:Skin/\:fittyfene
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
669 and afterwards ~/.mplayer/\:Skin/\:fittyfene.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
670 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
671 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
672 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
673 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
674 .B \-slave (also see \-input)
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
675 Switches on slave mode, in which MPlayer works as a backend for other programs.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
676 Instead of intercepting keyboard events, MPlayer will read commands from stdin.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
677 .br
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
678 .I NOTE:
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
679 See \-input cmdlist for a list of slave commands and DOCS/\:tech/\:slave.txt
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
680 for their description.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
681 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
682 .TP
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
683 .B \-softsleep
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
684 Use high-quality software timers instead of the RTC.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
685 As precise as the RTC without requiring special privileges.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
686 Comes at the price of higher CPU consumption.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
687 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
688 .TP
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
689 .B \-speed <0.01\-100>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
690 Slow down or speed up playback by the factor given as parameter.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
691 .
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
692 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
693 .B \-sstep <sec>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
694 Display one frame every <sec> seconds.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
695 Useful for slideshows.
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
696 Since MPlayer can only seek to the next keyframe this may be inexact.
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
697 Most formats have one keyframe every <sec> and <sec>+20 seconds.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
698 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
699 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
700 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
701 .SH "DEMUXER/\:STREAM OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
702 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
703 .TP
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
704 .B \-a52drc <level>
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
705 Select the Dynamic Range Compression level for AC3 audio streams.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
706 <level> is a float value ranging from 0 to 1, where 0 means no compression
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
707 and 1 (which is the default) means full compression (make loud passages more
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
708 silent and vice versa).
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
709 This option only shows an effect if the AC3 stream contains the required range
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
710 compression information.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
711 .
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
712 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
713 .B \-aid <ID> (also see \-alang)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
714 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
715 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
716 MPlayer prints the available IDs when run in verbose (\-v) mode.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
717 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
718 (if present) with the chosen audio stream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
719 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
720 .TP
13556
1b2b37c0bd4d -alang needs a language code, not a country code.
diego
parents: 13545
diff changeset
721 .B \-alang <language\ code> (also see \-aid)
13543
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
722 Play the audio stream whose language matches the given code.
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
723 Different container formats employ different language codes.
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
724 DVDs use ISO 639-1 two letter language codes, Matroska and NUT use ISO 639-2
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
725 three letter language codes while OGM uses a free-form identifier.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
726 MPlayer prints a list of available languages when run in verbose (\-v) mode.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
727 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
728 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
729 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
730 .RSs
13543
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
731 .IPs "mplayer dvd://1 \-alang hu,en"
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
732 Chooses the Hungarian language track on a DVD and falls back on English if
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
733 Hungarian is not available.
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
734 .IPs "mplayer \-alang jpn example.mkv"
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
735 Plays a Matroska file in Japanese.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
736 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
737 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
738 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
739 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
740 .B \-audio-demuxer <number> (\-audiofile only)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
741 Force audio demuxer type for \-audiofile.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
742 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
743 \-audio-demuxer 17 forces MP3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
744 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
745 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
746 .B \-audiofile <filename>
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
747 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
748 movie.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
749 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
750 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
751 .B \-audiofile-cache <kBytes>
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
752 Enables caching for the stream used by \-audiofile, using the specified
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
753 amount of memory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
754 .
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
755 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
756 .B \-bandwidth <value> (network only)
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
757 Specify the maximum bandwidth for network streaming (for servers that are
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
758 able to send content in different bitrates).
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
759 Useful if you want to watch live streamed media behind a slow connection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
760 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
761 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
762 .B \-cdrom-device <path\ to\ device>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
763 Specify the CD-ROM device (default: /dev/\:cdrom).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
764 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
765 .TP
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
766 .B \-cache <kBytes>
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
767 This option specifies how much memory (in kBytes) to use when precaching a
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
768 file or URL.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
769 Especially useful on slow media.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
770 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
771 .TP
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
772 .B \-cache-min <percentage>
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
773 Playback will start when the cache fill threshold set with this option
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
774 is reached.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
775 .
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
776 .TP
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
777 .B \-cache-prefill <percentage> (not yet implemented)
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
778 When the cache is emptied MPlayer will pause and restart playback when
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
779 the cache prefill threshold set with this option is reached.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
780 .
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
781 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
782 .B \-cdda <option1:option2> (CDDA only)
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
783 This option can be used to tune the CD Audio reading feature of MPlayer.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
784 .sp 1
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
785 Available options are:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
786 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
787 .IPs speed=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
788 Set CD spin speed.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
789 .IPs paranoia=<0\-2>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
790 Set paranoia level.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
791 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
792 0: disable checking
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
793 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
794 1: overlap checking only (default)
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
795 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
796 2: full data correction and verification
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
797 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
798 .IPs generic-dev=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
799 Use specified generic SCSI device.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
800 .IPs sector-size=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
801 Set atomic read size.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
802 .IPs overlap=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
803 Force minimum overlap search during verification to <value> sectors.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
804 .IPs toc-bias
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
805 Assume that the beginning offset of track 1 as reported in the TOC will be
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
806 addressed as LBA\ 0.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
807 Some Toshiba drives need this for getting track boundaries correct.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
808 .IPs toc-offset=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
809 Add <value> sectors to the values reported when addressing tracks.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
810 May be negative.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
811 .IPs (no)skip
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
812 (Never) accept imperfect data reconstruction.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
813 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
814 .
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
815 .TP
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
816 .B \-channels <number>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
817 Change the number of playback channels (default: 2).
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
818 If the number of output channels is bigger than the number of input channels
8176
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
819 empty channels are inserted (unless mixing from mono to stereo, then the mono
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
820 channel is repeated in both output channels).
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
821 If the number of output channels is smaller than the number of input channels,
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
822 results depend on the audio decoder (\-afm).
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
823 MPlayer asks the decoder to decode the audio into as many channels as
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
824 specified.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
825 Now it's up to the decoder to fulfill the requirement.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
826 If the decoder outputs more channels than requested, the exceeding channels
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
827 are truncated.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
828 This is usually only important when playing videos with AC3 audio (like DVDs).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
829 In that case liba52 does the decoding by default and correctly downmixes the
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
830 audio into the requested number of channels.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
831 .br
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
832 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
833 This option is honored by codecs (AC3 only), filters (surround) and ao drivers
8176
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
834 (OSS at least).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
835 .sp 1
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
836 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
837 .sp 1
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
838 .PD 0
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
839 .RSs
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
840 .IPs 2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
841 stereo
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
842 .IPs 4
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
843 surround
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
844 .IPs 6
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
845 full 5.1
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
846 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
847 .PD 1
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
848 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
849 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
850 .B \-chapter <chapter\ ID>[\-<end\ chapter\ ID>] (DVD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
851 Specify which chapter to start playing at.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
852 Optionally specify which chapter to end playing at (default: 1).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
853 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
854 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
855 .B \-cookies (network only)
11583
2af52902e7dc Send HTTP Cookies (reading from mozilla/netscape files) support by Dave Lambley <mplayer-dev-eng@dlambley.freeserve.co.uk>. Disabled by default.
alex
parents: 11581
diff changeset
856 Send cookies when making HTTP requests.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
857 .
11583
2af52902e7dc Send HTTP Cookies (reading from mozilla/netscape files) support by Dave Lambley <mplayer-dev-eng@dlambley.freeserve.co.uk>. Disabled by default.
alex
parents: 11581
diff changeset
858 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
859 .B \-cookies-file <filename> (network only)
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
860 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
861 and skip reading from default locations.
11603
fbef9326c2ed small fixes
diego
parents: 11600
diff changeset
862 The file is assumed to be in Netscape format.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
863 .
11583
2af52902e7dc Send HTTP Cookies (reading from mozilla/netscape files) support by Dave Lambley <mplayer-dev-eng@dlambley.freeserve.co.uk>. Disabled by default.
alex
parents: 11581
diff changeset
864 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
865 .B \-demuxer <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
866 Force demuxer type.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
867 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
868 \-demuxer 17 forces MP3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
869 .
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
870 .TP
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
871 .B \-dumpaudio (MPlayer only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
872 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC3).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
873 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
874 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
875 .B \-dumpfile <filename> (MPlayer only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
876 Specify which file MPlayer should dump to.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
877 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
878 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
879 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
880 .B \-dumpstream (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
881 Dumps the raw stream to ./stream.dump.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
882 Useful when ripping from DVD or network.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
883 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
884 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
885 .B \-dumpvideo (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
886 Dump raw compressed video stream to ./stream.dump (not very usable).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
887 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
888 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
889 .B \-dvbin <options> (DVB only)
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
890 Pass the following parameters to the DVB input module, in order to override
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
891 the default ones:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
892 .sp 1
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
893 .PD 0
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
894 .RSs
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
895 .IPs card=<1\-4>
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
896 Specifies using card number 1\-4 (default: 1).
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
897 .IPs file=<filename>
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
898 Instructs MPlayer to read the channels list from <filename>.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
899 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl} (based on your card type)
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
900 or ~/.mplayer/\:channels.conf as a last resort.
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
901 .RE
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
902 .PD 1
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
903 .
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
904 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
905 .B \-dvd-device <path\ to\ device> (DVD only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
906 Specify the DVD device (default: /dev/\:dvd).
13510
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
907 You can also specify a directory that contains files previously copied directly
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
908 from a DVD (with e.g.\& vobcopy).
13510
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
909 Note that using \-dumpstream is usually a better way to
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
910 copy DVD titles in the first place (see the examples).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
911 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
912 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
913 .B \-dvdangle <angle\ ID> (DVD only)
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
914 Some DVD discs contain scenes that can be viewed from multiple angles.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
915 Here you can tell MPlayer which angles to use (default: 1).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
916 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
917 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
918 .B \-forceidx
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
919 Force index rebuilding.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
920 Useful for files with broken index (A/\:V desync, etc).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
921 This will enable seeking in files where seeking was not possible.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
922 You can fix the index permanently with MEncoder (see the documentation).
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
923 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
924 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
925 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
926 (i.e.\& not with stdin, pipe, etc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
927 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
928 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
929 .B \-fps <float value>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
930 Override video framerate.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
931 Useful if the original value is wrong or missing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
932 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
933 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
934 .B \-frames <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
935 Play/\:convert only first <number> frames, then quit.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
936 .
472
a25ba0fd865e commiting yesterday's changes that accidently lost ;(((
gabucino
parents: 454
diff changeset
937 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
938 .B \-hr-mp3-seek (MP3 only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
939 Hi-res MP3 seeking.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
940 Enabled when playing from an external MP3 file, as we need to seek
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
941 to the very exact position to keep A/\:V sync.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
942 Can be slow especially when seeking backwards since it has to rewind
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
943 to the beginning to find an exact frame position.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
944 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
945 .TP
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
946 .B \-idx (also see \-forceidx)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
947 Rebuilds index of files if no index was found, allowing seeking.
12697
86ca4e017ac8 Real now supports index building as well.
diego
parents: 12662
diff changeset
948 Useful with broken/\:incomplete downloads, or badly created files.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
949 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
950 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
951 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
952 (i.e.\& not with stdin, pipe, etc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
953 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
954 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
955 .B \-ipv4-only-proxy (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
956 Skip the proxy for IPv6 addresses.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
957 It will still be used for IPv4 connections.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
958 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
959 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
960 .B \-loadidx <index file>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
961 The file from which to read the video index data saved by \-saveidx.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
962 This index will be used for seeking, overriding any index data
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
963 contained in the AVI itself.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
964 MPlayer won't prevent you from loading an index file generated
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
965 from a different AVI, but this is sure to cause unfavorable results.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
966 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
967 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
968 This option is obsolete now that MPlayer has OpenDML support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
969 .
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
970 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
971 .B \-mc <seconds/\:frame>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
972 maximum A-V sync correction per frame (in seconds)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
973 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
974 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
975 .B \-mf <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
976 Used when decoding from multiple PNG or JPEG files.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
977 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
978 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
979 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
980 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
981 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
982 .IPs w=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
983 output width (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
984 .IPs h=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
985 output height (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
986 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
987 output fps (default: 25)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
988 .IPs type=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
989 input file type (available: jpeg, png, tga, sgi)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
990 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
991 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
992 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
993 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
994 .B \-ni (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
995 Force usage of non-interleaved AVI parser (fixes playback
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
996 of some bad AVI files).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
997 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
998 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
999 .B \-nobps (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1000 Do not use average byte/\:second value for A-V sync.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1001 Helps with some AVI files with broken header.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1002 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1003 .TP
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
1004 .B \-noextbased
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1005 Disables extension-based demuxer selection.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1006 By default, when the file type (demuxer) cannot be detected reliably
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
1007 (the file has no header or it is not reliable enough), the filename
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1008 extension is used to select the demuxer.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1009 Always falls back on content-based demuxer selection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1010 .
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
1011 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1012 .B \-passwd <password> (also see \-user) (network only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1013 Specify password for HTTP authentication.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1014 .
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
1015 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1016 .B \-prefer-ipv4 (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
1017 Use IPv4 on network connections.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1018 Falls back on IPv6 automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1019 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
1020 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1021 .B \-prefer-ipv6 (IPv6 network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
1022 Use IPv6 on network connections.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1023 Falls back on IPv4 automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1024 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
1025 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1026 .B \-rawaudio <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1027 This option lets you play raw audio files.
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
1028 It may also be used to play audio CDs which are not 44KHz 16-bit stereo.
12948
41adb115f73b missing \ before -rawaudio
reimar
parents: 12944
diff changeset
1029 For playing raw AC3 streams use \-rawaudio on:format=0x2000.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1030 .sp 1
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
1031 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1032 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1033 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1034 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1035 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1036 Use raw audio demuxer.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1037 .IPs channels=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1038 number of channels
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1039 .IPs rate=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1040 rate in samples per second
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1041 .IPs samplesize=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1042 sample size in bytes
12282
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
1043 .IPs bitrate=<value>
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
1044 bitrate for rawaudio files
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1045 .IPs format=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1046 fourcc in hex
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1047 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1048 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1049 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1050 .TP
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1051 .B \-rawvideo <option1:option2:...>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1052 This option lets you play raw video files.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1053 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1054 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1055 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1056 .PD 0
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1057 .RSs
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1058 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1059 Use raw video demuxer.
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1060 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1061 rate in frames per second (default: 25.0)
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1062 .IPs sqcif|qcif|cif|4cif|pal|ntsc
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1063 set standard image size
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1064 .IPs w=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1065 image width in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1066 .IPs h=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1067 image height in pixels
14166
c7822e66c36f y420 vs i420 typo
diego
parents: 14149
diff changeset
1068 .IPs i420|yv12|yuy2|y8
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1069 set colorspace
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1070 .IPs format=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1071 colorspace (fourcc) in hex
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1072 .IPs size=<value>
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
1073 frame size in Bytes
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1074 .RE
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1075 .PD 1
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1076 .
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1077 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1078 .B \-rtsp-stream-over-tcp (live.com only)
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
1079 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1080 packets be streamed over TCP (using the same TCP connection as RTSP).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1081 This option may be useful if you have a broken internet connection that does
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1082 not pass incoming UDP packets (see http://www.live.com/\:mplayer/).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1083 .
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
1084 .TP
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
1085 .B \-saveidx <filename>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1086 Force index rebuilding and dump the index to <filename>.
11293
e9f585aec12e -loadidx and -saveidx explanation extended.
diego
parents: 11286
diff changeset
1087 Currently this only works with AVI files.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1088 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1089 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1090 This option is obsolete now that MPlayer has OpenDML support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1091 .
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
1092 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1093 .B \-sb <byte\ position> (also see \-ss)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1094 Seek to byte position.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1095 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1096 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1097 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1098 .B \-srate <Hz>
11906
47e9cd92d163 Fix description of -srate, as pointed out by Rich.
diego
parents: 11904
diff changeset
1099 Selects the given output sampling rate, resampling if necessary.
13723
d7f78525d89b missing \
wight
parents: 13710
diff changeset
1100 The type of resampling can be controlled by the \-af-adv option.
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
1101 The default is fast resampling that may cause distortion.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1102 MEncoder passes this value to LAME for resampling.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1103 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1104 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1105 .B \-ss <time> (also see \-sb)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1106 Seek to given time position.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1107 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1108 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1109 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1110 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1111 .IPs "\-ss 56"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1112 Seeks to 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1113 .IPs "\-ss 01:10:00"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1114 Seeks to 1\ hour 10\ min.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1115 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1116 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1117 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1118 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1119 .B \-tskeepbroken
11203
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1120 Tells MPlayer not to discard TS packets reported as broken in the stream.
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1121 Sometimes needed to play corrupted MPEG-TS files.
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1122 .
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1123 .TP
12994
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1124 .B \-tsprobe <byte\ position>
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1125 When playing an MPEG-TS stream, this option lets you specify how many
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1126 bytes in the stream you want MPlayer to search for the desired
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1127 audio and video pids.
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1128 .
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1129 .TP
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1130 .B \-tsprog <1\-65534>
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1131 When playing an MPEG-TS stream, you can specify with this option which
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1132 program (if present) you want to play.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1133 Can be used with \-vid and \-aid.
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1134 .
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1135 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1136 .B \-tv <option1:option2:...> (TV only)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1137 This option tunes various properties of the TV capture module.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1138 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
10023
5a06b5774c00 Selecting tv channel by name (tv://) documentation.
diego
parents: 10003
diff changeset
1139 or even 'tv://<channel_name> (see option channels for channel_name below)
5a06b5774c00 Selecting tv channel by name (tv://) documentation.
diego
parents: 10003
diff changeset
1140 as a movie URL.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1141 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1142 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1143 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1144 .IPs noaudio
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1145 no sound
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1146 .IPs driver=<value>
10537
31f12f99118b v4l2 support
henry
parents: 10524
diff changeset
1147 available: dummy, v4l, v4l2, bsdbt848
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1148 .IPs device=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1149 Specify TV device (default: /dev/\:video0).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1150 .IPs input=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1151 Specify input (default: 0 (TV), see console output for available inputs).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1152 .IPs freq=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1153 Specify the frequency to set the tuner to (e.g.\& 511.250).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1154 Not compatible with the channels parameter.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1155 .IPs outfmt=<value>
11365
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1156 Specify the output format of the tuner with a preset value supported by the
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1157 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1158 arbitrary format given as hex value.
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1159 Try outfmt=help for a list of all available formats.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1160 .IPs width=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1161 output window width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1162 .IPs height=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1163 output window height
8879
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1164 .IPs fps=<value>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1165 framerate at which to capture video (frames per second)
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1166 .IPs buffersize=<value>
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
1167 maximum size of the capture buffer in megabytes (default: dynamical)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1168 .IPs norm=<value>
13979
d5dff36405c3 v4l2 norm setting
henry
parents: 13965
diff changeset
1169 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
d5dff36405c3 v4l2 norm setting
henry
parents: 13965
diff changeset
1170 For v4l2, see the console output for a list of all available norms,
d5dff36405c3 v4l2 norm setting
henry
parents: 13965
diff changeset
1171 also see the normid option below.
13016
61d0fd8411cc Missing quotes added
wight
parents: 13014
diff changeset
1172 .IPs "normid=<value> (v4l2 only)"
14003
a51f75602994 wording
diego
parents: 13996
diff changeset
1173 Sets the TV norm to the given numeric ID.
a51f75602994 wording
diego
parents: 13996
diff changeset
1174 The TV norm depends on the capture card.
a51f75602994 wording
diego
parents: 13996
diff changeset
1175 See the console output for a list of available TV norms.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1176 .IPs channel=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1177 Set tuner to <value> channel.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1178 .IPs chanlist=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1179 available: europe-east, europe-west, us-bcast, us-cable, etc
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
1180 .IPs channels=<channel>\-<name>,<channel>\-<name>,...
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1181 Set names for channels.
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1182 Use _ for spaces in names (or play with quoting ;-).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1183 The channel names will then be written using OSD, and the slave commands
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1184 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1185 a remote control (see LIRC).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1186 Not compatible with the frequency parameter.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1187 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1188 .I NOTE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1189 The channel number will then be the position in the 'channels' list,
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1190 beginning with 1.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1191 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1192 .I EXAMPLE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1193 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1194 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1195 Set the image equalizer on the card.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1196 .IPs audiorate=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1197 Set audio capture bitrate.
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1198 .IPs forceaudio
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1199 Capture audio even if there are no audio sources reported by v4l.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1200 .IPs alsa\
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1201 Capture from ALSA.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1202 .IPs amode=<0\-3>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1203 Choose an audio mode:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1204 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1205 0: mono
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1206 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1207 1: stereo
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1208 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1209 2: language 1
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1210 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1211 3: language 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1212 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1213 .IPs forcechan=<1\-2>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1214 By default, the count of recorded audio channels is determined automatically
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1215 by querying the audio mode from the TV card.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1216 This option allows forcing stereo/\:mono recording regardless of the amode
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1217 option and the values returned by v4l.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1218 This can be used for troubleshooting when the TV card is unable to report the
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1219 current audio mode.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1220 .IPs adevice=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1221 Set an audio device.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1222 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1223 See the \-ao alsa documentation to find out how to specify the hardware ID.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1224 .IPs audioid=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1225 Choose an audio output of the capture card, if it has more than one.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1226 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1227 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1228 These options set parameters of the mixer on the video capture card.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1229 They will have no effect, if your card does not have one.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1230 For v4l2 50 maps to the default value of the
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
1231 control, as reported by the driver.
8879
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1232 .IPs immediatemode=<bool>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1233 A value of 0 means capture and buffer audio and video together
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1234 (default for MEncoder).
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1235 A value of 1 (default for MPlayer) means to do video capture only and let the
13533
diego
parents: 13525
diff changeset
1236 audio go through a loopback cable from the TV card to the sound card.
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1237 .IPs mjpeg
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1238 Use hardware MJPEG compression (if the card supports it).
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1239 When using this option, you do not need to specify the width and height
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1240 of the output window, because MPlayer will determine it automatically
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1241 from the decimation value (see below).
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1242 .IPs decimation=<1,2,4>
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1243 choose the size of the picture that will be compressed by hardware
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1244 MJPEG compression:
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1245 .RSss
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1246 1: full size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1247 704x576 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1248 704x480 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1249 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1250 2: medium size
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1251 352x288 PAL
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1252 352x240 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1253 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1254 4: small size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1255 176x144 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1256 176x120 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1257 .REss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1258 .IPs quality=<0\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1259 Choose the quality of the JPEG compression
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1260 (< 60 recommended for full size).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1261 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1262 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1263 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1264 .B \-user <username> (also see \-passwd) (network only)
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1265 Specify username for HTTP authentication.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1266 .
7108
3284ffd653b3 added detailed vop description, rtsp, aid range, user option, two examples, files documentation - removed gui option, *_intensity options, old input system (Joey Parrish)
jonas
parents: 7070
diff changeset
1267 .TP
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1268 .B \-user-agent <string>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1269 Use <string> as user agent for HTTP streaming.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1270 .
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1271 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1272 .B \-vid <ID>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1273 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1274 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1275 (if present) with the chosen video stream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1276 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1277 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1278 .B \-vivo <sub-options> (DEBUG CODE)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1279 Force audio parameters for the VIVO demuxer (for debugging purposes).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1280 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1281 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1282 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1283 .SH "OSD/\:SUB OPTIONS"
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1284 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1285 Also see \-vf expand.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1286 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1287 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1288 .B \-dumpjacosub (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1289 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1290 JACOsub subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1291 Creates a dumpsub.js file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1292 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1293 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1294 .B \-dumpmicrodvdsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1295 Convert the given subtitle (specified with the \-sub option) to the
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1296 MicroDVD subtitle format.
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1297 Creates a dumpsub.sub file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1298 .
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1299 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1300 .B \-dumpmpsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1301 Convert the given subtitle (specified with the \-sub option) to MPlayer's
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1302 subtitle format, MPsub.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1303 Creates a dump.mpsub file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1304 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1305 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1306 .B \-dumpsami (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1307 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1308 SAMI subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1309 Creates a dumpsub.smi file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1310 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1311 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1312 .B \-dumpsrtsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1313 Convert the given subtitle (specified with the \-sub option) to the time-based
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1314 SubViewer (SRT) subtitle format.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1315 Creates a dumpsub.srt file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1316 .
6378
64a828f1872b added -dumpsrtsub
gabucino
parents: 6351
diff changeset
1317 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1318 .B \-dumpsub (MPlayer only) (BETA CODE)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
1319 Dumps the subtitle substream from VOB streams.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1320 Also see the \-dump*sub and \-vobsubout* options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1321 .
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
1322 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1323 .B \-ffactor <number> (OSD only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1324 Resample the font alphamap.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1325 Can be:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1326 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1327 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1328 .IPs 0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1329 plain white fonts
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1330 .IPs 0.75
8762
75d22ee5f975 Per-file configuration, typos, rewordings, consistency and a 10l .In.
diego
parents: 8745
diff changeset
1331 very narrow black outline (default)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1332 .IPs 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1333 narrow black outline
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1334 .IPs 10
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1335 bold black outline
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1336 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1337 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1338 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1339 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1340 .B \-flip-hebrew (FriBiDi only)
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1341 Turns on flipping subtitles using FriBiDi.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1342 .
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1343 .TP
13679
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1344 .B \-noflip-hebrew-commas
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1345 Change FriBiDi's assumptions about the placements of commas in subtitles.
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1346 Use this if commas in subtitles are shown at the start of a sentence
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1347 instead of at the end.
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1348 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1349 .B \-font <path\ to\ font.desc\ file> (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1350 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1351 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1352 ~/.mplayer/\:subfont.ttf).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1353 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1354 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1355 With FreeType, this option determines the path to the text font file.
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
1356 With fontconfig, this option determines the fontconfig font name.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1357 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1358 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1359 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1360 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1361 \-font ~/\:.mplayer/\:arial-14/\:font.desc
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1362 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1363 \-font ~/\:.mplayer/\:arialuni.ttf
11580
90953d955165 Fontconfig support based on patch by Arwed von Merkatz <v.merkatz@gmx.net>, but slightly reworked
alex
parents: 11572
diff changeset
1364 .br
90953d955165 Fontconfig support based on patch by Arwed von Merkatz <v.merkatz@gmx.net>, but slightly reworked
alex
parents: 11572
diff changeset
1365 \-font 'Bitstream Vera Sans'
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1366 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1367 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1368 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1369 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1370 .B \-fontconfig (fontconfig only)
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1371 Enables the usage of fontconfig managed fonts.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1372 .
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1373 .TP
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1374 .B \-forcedsubsonly
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1375 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1376 \-slang.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1377 .
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1378 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1379 .B \-fribidi-charset <charset\ name> (FriBiDi only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1380 Specifies the character set that will be passed to FriBiDi when
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1381 decoding non-UTF-8 subtitles (default: ISO8859-8).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1382 .
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1383 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1384 .B \-ifo <VOBsub\ ifo\ file>
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1385 Indicate the file that will be used to load palette and frame size for VOBsub
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1386 subtitles.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1387 .
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1388 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1389 .B \-noautosub
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1390 Turns off automatic subtitle file loading.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1391 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1392 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1393 .B \-osdlevel <0\-3> (MPlayer only)
8810
bdcde34deb14 10l, osdlevel, fixes
jonas
parents: 8806
diff changeset
1394 Specifies which mode the OSD should start in.
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1395 .PD 0
8811
jonas
parents: 8810
diff changeset
1396 .RSs
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1397 .IPs 0
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1398 subtitles only
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1399 .IPs 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1400 volume + seek (default)
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1401 .IPs 2
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1402 volume + seek + timer + percentage
9162
jonas
parents: 9139
diff changeset
1403 .IPs 3
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1404 volume + seek + timer + percentage + total time
8811
jonas
parents: 8810
diff changeset
1405 .RE
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1406 .PD 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1407 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1408 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1409 .B \-overlapsub
10393
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1410 Allows the next subtitle to be displayed while the current one is
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1411 still visible (default is to enable the support only for specific
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1412 formats).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1413 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1414 .TP
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1415 .B \-sid <ID> (also see \-slang option)
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1416 Display DVD subtitles in the language specified by <ID> (0\-31).
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1417 MPlayer prints the available subtitle languages when run in verbose (\-v) mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1418 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1419 .TP
13160
7dbbfba0a722 better -slang description inspired by a patch from Guillaume Poirier
diego
parents: 13159
diff changeset
1420 .B \-slang <country\ code[,country\ code,...]> (also see \-sid)
7dbbfba0a722 better -slang description inspired by a patch from Guillaume Poirier
diego
parents: 13159
diff changeset
1421 Specify a priority list of DVD subtitle languages to use.
7dbbfba0a722 better -slang description inspired by a patch from Guillaume Poirier
diego
parents: 13159
diff changeset
1422 Languages must be given as two letter country codes.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1423 MPlayer prints the available subtitle languages when run in verbose (\-v) mode.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1424 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1425 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1426 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1427 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1428 .IPs "\-slang hu,en"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1429 Selects Hungarian and falls back on English if Hungarian is not available.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1430 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1431 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1432 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1433 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1434 .B \-spuaa <mode> (OSD only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1435 Antialiasing/\:scaling mode for DVD/\:VOBsub.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1436 A value of 16 may be added to <mode> in order to force scaling even
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1437 when original and scaled frame size already match.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1438 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1439 Available modes are:
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1440 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1441 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1442 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1443 none (fastest, very ugly)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1444 .IPs 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1445 approximate (broken?)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1446 .IPs 2
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1447 full (slow)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1448 .IPs 3
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1449 bilinear (default, fast and not too bad)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1450 .IPs 4
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1451 uses swscaler gaussian blur (looks very good)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1452 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1453 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1454 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1455 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1456 .B \-spualign <-1\-2> (OSD only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1457 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1458 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1459 .RSs
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1460 .IPs "-1"
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1461 original position
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1462 .IPs " 0"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1463 align at top (original/\:default behavior)
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1464 .IPs " 1"
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1465 align at center
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1466 .IPs " 2"
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1467 align at bottom
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1468 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1469 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1470 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1471 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1472 .B \-spugauss <0.0\-3.0> (OSD only)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1473 Variance parameter of gaussian used by \-spuaa 4.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1474 Higher means more blur (default: 1.0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1475 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1476 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1477 .B \-sub <subtitlefile1,subtitlefile2,...>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1478 Use/\:display these subtitle files.
13134
2c3a4098f40c Cycle through the available subtitles with 'b'.
diego
parents: 13107
diff changeset
1479 Only one file can be displayed at the same time.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1480 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1481 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1482 .B \-sub-bg-alpha <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1483 Specify the alpha channel value for subtitles and OSD backgrounds.
8762
75d22ee5f975 Per-file configuration, typos, rewordings, consistency and a 10l .In.
diego
parents: 8745
diff changeset
1484 Big values mean more transparency.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1485 0 means completely transparent.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1486 .
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1487 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1488 .B \-sub-bg-color <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1489 Specify the color value for subtitles and OSD backgrounds.
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1490 Currently subtitles are grayscale so this value is equivalente to the
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1491 intensity of the color.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1492 255 means white and 0 black.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1493 .
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1494 .TP
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1495 .B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1496 Force subtitle demuxer type for \-subfile.
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1497 Give the demuxer ID as defined in subreader.h.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1498 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1499 .TP
11448
gabucino
parents: 11446
diff changeset
1500 .B \-sub-fuzziness <mode>
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1501 Adjust matching fuzziness when searching for subtitles:
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1502 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1503 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1504 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1505 exact match
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1506 .IPs 1
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1507 Load all subs containing movie name.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1508 .IPs 2
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1509 Load all subs in the current directory.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1510 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1511 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1512 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1513 .TP
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1514 .B \-sub-no-text-pp
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1515 Disables any kind of text post processing done after loading the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1516 Used for debug purposes.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1517 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1518 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1519 .B \-subalign <0\-2> (OSD only)
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1520 Specify how subtitles should be aligned with \-subpos.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1521 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1522 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1523 .IPs 0
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
1524 Align at top (original/\:default behavior).
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1525 .IPs 1
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
1526 Align at center.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1527 .IPs 2
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
1528 Align at bottom.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1529 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1530 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1531 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1532 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1533 .B \-subcc \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1534 Display DVD Closed Caption (CC) subtitles.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1535 These are NOT the VOB subtitles, these are special ASCII subtitles for the
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1536 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1537 CC subtitles have not been spotted on DVDs from other regions so far.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1538 .
7049
0caeda287ff9 -subcc option documented, patch by Robert R. Wal <rrw at hell pl>.
diego
parents: 7045
diff changeset
1539 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1540 .B \-subcp <codepage> (iconv only)
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1541 If your system supports iconv(3), you can use this option to
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1542 specify the subtitle codepage.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1543 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1544 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1545 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1546 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1547 \-subcp latin2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1548 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1549 \-subcp cp1250
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1550 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1551 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1552 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1553 .TP
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1554 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1555 You can specify your language using a two letter language code to
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1556 make ENCA detect the codepage automatically.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1557 If unsure, enter anything and watch mplayer \-v output for available
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1558 languages.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1559 Fallback codepage specifies the codepage to use, when autodetection fails.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1560 .sp 1
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1561 .I EXAMPLE:
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1562 .PD 0
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1563 .RSs
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1564 .IPs "\-subcp enca:cs:latin2"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1565 Guess the encoding, assuming the subtitles are Czech, fall back on
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1566 latin 2, if the detection fails.
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1567 .IPs "\-subcp enca:pl:cp1250"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1568 Guess the encoding for Polish, fall back on cp1250.
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1569 .RE
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1570 .PD 1
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1571 .
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1572 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1573 .B \-subdelay <sec>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1574 Delays subtitles by <sec> seconds.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1575 Can be negative.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1576 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1577 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1578 .B \-subfile <filename> (BETA CODE)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1579 Currently useless.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1580 Same as \-audiofile, but for subtitle streams (OggDS?).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1581 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1582 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1583 .B \-subfont-autoscale <0\-3> (FreeType only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1584 Sets the autoscale mode.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1585 .br
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
1586 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1587 0 means that text scale and OSD scale are font heights in points.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1588 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1589 The mode can be:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1590 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1591 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1592 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1593 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1594 no autoscale
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1595 .IPs 1
8265
rfelker
parents: 8248
diff changeset
1596 proportional to movie height
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1597 .IPs 2
8265
rfelker
parents: 8248
diff changeset
1598 proportional to movie width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1599 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1600 proportional to movie diagonal (default)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1601 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1602 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1603 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1604 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1605 .B \-subfont-blur <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1606 Sets the font blur radius (default: 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1607 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1608 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1609 .B \-subfont-encoding <value> (FreeType only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1610 Sets the font encoding.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1611 When set to 'unicode', all the glyphs from the font file will be rendered and
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1612 unicode will be used (default: unicode).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1613 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1614 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1615 .B \-subfont-osd-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1616 Sets the autoscale coefficient of the OSD elements (default: 6).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1617 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1618 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1619 .B \-subfont-outline <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1620 Sets the font outline thickness (default: 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1621 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1622 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1623 .B \-subfont-text-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1624 Sets the subtitle text autoscale coefficient as percentage of the
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1625 screen size (default: 5).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1626 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1627 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1628 .B \-subfps <rate>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1629 Specify the framerate of the subtitle file (default: movie fps).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1630 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1631 .I NOTE:
13364
034bdc681643 MicroDVD IS a frame-based subtitle format, mistake noticed by Jiri Heryan
diego
parents: 13363
diff changeset
1632 Only for frame-based subtitle files, i.e.\& MicroDVD format.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1633 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1634 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1635 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1636 Specify the position of subtitles on the screen.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1637 The value is the vertical position of the subtitle in % of the screen height.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1638 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1639 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1640 .B \-subwidth <10\-100> (OSD only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1641 Specify the maximum width of subtitles on the screen.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1642 Useful for TV-out.
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1643 The value is the width of the subtitle in % of the screen width.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1644 .
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1645 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1646 .B \-unicode
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1647 Tells MPlayer to handle the subtitle file as unicode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1648 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1649 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1650 .B \-utf8 \ \
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1651 Tells MPlayer to handle the subtitle file as UTF-8.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1652 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1653 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1654 .B \-vobsub <VOBsub\ file\ without\ extension>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1655 Specify a VOBsub file to use for subtitles.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1656 Has to be the full pathname without extension, i.e.\& without
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1657 the '.idx', '.ifo' or '.sub'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1658 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1659 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1660 .B \-vobsubid <0\-31>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1661 Specify the VOBsub subtitle ID.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1662 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1663 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1664 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1665 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1666 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1667 .TP
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
1668 .B \-abs <value> (\-ao oss only) (OBSOLETE)
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1669 Override audio driver/\:card buffer size detection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1670 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1671 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
1672 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1673 Specify audio plugin(s) and their options
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1674 (also see the audio plugins section of the documentation).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1675 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1676 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1677 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1678 .IPs list=[plugins]
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1679 comma separated list of plugins (resample, surround, format, volume,
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1680 extrastereo, volnorm, delay)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1681 .IPs delay=<sec>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1682 example plugin, do not use (delay plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1683 .IPs format=<format>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1684 output format (format plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1685 .IPs fout=<Hz>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1686 output frequency (resample plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1687 .IPs volume=<0\-255>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1688 volume (volume plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1689 .IPs mul=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1690 stereo coefficient (default: 2.5) (extrastereo plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1691 .IPs softclip
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1692 compressor / 'soft-clipping' capabilities (volume plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1693 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1694 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1695 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1696 .B \-delay <sec>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1697 Audio delay in seconds (positive or negative float value).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1698 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1699 .TP
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1700 .B \-format <0\-8192>
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1701 Select the format used for output from the filter layer (according to the
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1702 defines in libao2/\:afmt.h):
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1703 .PD 0
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1704 .RSs
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1705 .IPs " 1"
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1706 Mu-Law
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1707 .IPs " 2"
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1708 A-Law
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1709 .IPs " 4"
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1710 Ima-ADPCM
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1711 .IPs " 8"
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1712 unsigned 8-bit
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1713 .IPs " 16"
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1714 signed 16-bit (little-endian)
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1715 .IPs " 32"
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1716 signed 16-bit (big-endian)
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1717 .IPs " 64"
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1718 signed 8-bit
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1719 .IPs " 128"
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1720 unsigned 16-bit (little-endian)
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1721 .IPs " 256"
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1722 unsigned 16-bit (big-endian)
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
1723 .IPs " 512"
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1724 MPEG (2) Audio
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1725 .IPs 1024
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1726 AC3
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1727 .IPs 4096
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1728 signed 32-bit (little-endian)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1729 .IPs 8192
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1730 signed 32-bit (big-endian)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1731 .RE
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1732 .PD 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1733 .
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1734 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1735 .B \-mixer <device>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1736 Use a mixer device different from the default /dev/\:mixer.
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1737 For ALSA this is the mixer name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1738 .
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1739 .TP
13434
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1740 .B \-mixer-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1741 This option will tell MPlayer to use a different channel for controlling
11840
acef84b653a9 small fixes
diego
parents: 11837
diff changeset
1742 volume than the default PCM.
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1743 Options for OSS include
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1744 .B vol, pcm, line.
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1745 For a complete list of options look for SOUND_DEVICE_NAMES in
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1746 /usr/\:include/\:linux/\:soundcard.h.
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1747 For ALSA you can use the names e.g.\& alsamixer displays, like
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1748 .B Master, Line, PCM.
13434
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1749 .br
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1750 .I NOTE:
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1751 ALSA mixer channel names followed by a number must be specified in the
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
1752 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
13434
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1753 be converted to
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
1754 .BR PCM,1 .
13933
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1755 .TP
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1756 .B \-softvol
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
1757 Force the use of the software mixer, instead of using the sound card
13933
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1758 mixer.
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1759 .
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1760 .TP
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1761 .B \-softvol-max <10.0\-10000.0>
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1762 Set the maximum amplification level in percent (default: 110).
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1763 A value of 200 will allow you to adjust the volume up to a maximum of
75b84965d137 allow forcing of software volume control and setting maximum amplification.
reimar
parents: 13930
diff changeset
1764 double the current level.
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
1765 With values below 100 the initial volume (which is 100%) will be above
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
1766 the maximum, which e.g.\& the OSD cannot display correctly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1767 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1768 .TP
13098
907fe1fdfc6c Make the stepsize of volume changes, changeable by a commandline paarameter
attila
parents: 13096
diff changeset
1769 .B \-volstep <0\-100>
13104
b818ad985ce9 default style
wight
parents: 13098
diff changeset
1770 Set the step size of mixer volume changes in percent of the whole range
b818ad985ce9 default style
wight
parents: 13098
diff changeset
1771 (default: 3).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1772 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1773 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1774 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1775 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
1776 Audio output drivers are interfaces to different audio output facilities.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1777 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1778 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1779 .TP
12505
a0b82f1dda7d xvmc and *vidix suboptions documented, better ao/vo suboption syntax
diego
parents: 12479
diff changeset
1780 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1781 Specify a priority list of audio output drivers to be used.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1782 .PP
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1783 If the list has a trailing ',' MPlayer will fall back on drivers not
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1784 contained in the list.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1785 Suboptions are optional and can mostly be omitted.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1786 .br
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1787 .I NOTE:
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
1788 See \-ao help for a list of compiled-in audio output drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1789 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1790 .I EXAMPLE:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1791 .PD 0
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1792 .RSs
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1793 .IPs "\-ao alsa,oss,"
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1794 Try the ALSA driver, then the OSS driver, then others.
12919
aba44b58dea7 Use = instead if # in ALSA device name, as # irritates our config-parser.
reimar
parents: 12867
diff changeset
1795 .IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1796 Sets noblock-mode, mmap-mode and the device-name as first card, fourth device.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1797 .RE
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1798 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1799 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1800 Available audio output drivers are:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1801 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1802 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1803 .B alsa\ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1804 ALSA 0.9/\:1.x audio output driver.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1805 .PD 0
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1806 .RSs
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1807 .IPs mmap\ \ \
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1808 Sets experimental mmap-mode (does not work for more than 2 channels).
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1809 .IPs noblock
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1810 Sets noblock-mode.
12807
6494aa5947ee ao_alsa now uses the device= suboption syntax instead of hw= or hw:
reimar
parents: 12778
diff changeset
1811 .IPs device=<device>
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1812 Sets the device name.
12919
aba44b58dea7 Use = instead if # in ALSA device name, as # irritates our config-parser.
reimar
parents: 12867
diff changeset
1813 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
13661
07dc40f25068 Only use S/PDIF output when no other alsa device is set, allows to use
reimar
parents: 13660
diff changeset
1814 Make sure you do not set this when you want hwac3 output via S/PDIF, unless
07dc40f25068 Only use S/PDIF output when no other alsa device is set, allows to use
reimar
parents: 13660
diff changeset
1815 you really know how to set it correctly.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1816 .RE
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1817 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1818 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1819 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1820 .B alsa5\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1821 ALSA 0.5 audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1822 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1823 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1824 .B oss\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1825 OSS audio output driver
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1826 .PD 0
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1827 .RSs
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1828 .IPs dsp-device
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1829 Sets the audio-output device (default: /dev/\:dsp).
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1830 .RE
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1831 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1832 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1833 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1834 .B sdl\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1835 Highly platform independent SDL (Simple Directmedia Layer) library
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1836 audio output driver.
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1837 .PD 0
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1838 .RSs
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1839 .IPs <driver>
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1840 Explicitly choose the SDL audio driver to use (default: let SDL choose).
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1841 .RE
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1842 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1843 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1844 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1845 .B arts\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1846 Audio output through the Arts daemon.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1847 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1848 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1849 .B esd\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1850 Audio output through the ESD daemon.
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1851 .PD 0
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1852 .RSs
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1853 .IPs <server>
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
1854 Explicitly choose the ESD server to use (default: localhost).
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1855 .RE
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1856 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1857 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1858 .TP
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1859 .B jack\ \ \ \
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1860 Audio output through JACK (Jack Audio Connection Kit).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1861 .
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1862 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1863 .B nas\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1864 Audio output through NAS.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1865 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1866 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1867 .B macosx (Mac OS X only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1868 Native Mac OS X audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1869 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1870 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1871 .B sgi (SGI only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1872 Native SGI audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1873 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1874 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1875 .B sun (Sun only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1876 Native Sun audio output driver.
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1877 .PD 0
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1878 .RSs
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1879 .IPs <device>
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1880 Explicitly choose the audio device to use (default: /dev/\:audio).
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1881 .RE
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1882 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1883 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1884 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1885 .B win32 (Windows only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1886 Native Windows waveout audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1887 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1888 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1889 .B dxr2 (also see \-dxr2) (DXR2 only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1890 Creative DXR2 specific output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1891 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1892 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1893 .B mpegpes (DVB only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1894 DVB specific output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1895 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1896 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1897 .B null\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1898 Produces no audio output but maintains video playback speed.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1899 Use \-nosound for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1900 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1901 .TP
14298
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1902 .B pcm
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1903 Raw PCM/\:wave file writer audio output.
14298
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1904 .PD 0
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1905 .RSs
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1906 .IPs (no)waveheader
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1907 Include or do not include the wave header (default: included).
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1908 When not included, raw PCM will be generated.
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1909 .IPs file=<filename>
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1910 Write the sound to <filename> instead of the default
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1911 audiodump.wav.
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1912 .REss
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1913 .PD 1
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1914 .RS
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1915 .sp 1
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1916 .I NOTE:
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1917 If you do not specify any option the output is progressive
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1918 (i.e.\& not interlaced).
3c818342a02b Add -ao pcm suboptions and remove -aofile and -waveheader options.
reimar
parents: 14259
diff changeset
1919 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1920 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1921 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1922 .B plugin\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1923 Plugin audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1924 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1925 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1926 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1927 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1928 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1929 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1930 .B \-aa* (\-vo aa only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1931 You can get a list and an explanation of available options executing
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1932 .I mplayer \-aahelp
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1933 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1934 .TP
12389
0b1053e9d8da -adapter is not directx specific anymore.
diego
parents: 12388
diff changeset
1935 .B \-adapter <value>
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1936 Set the graphics card that will receive the image.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1937 Needs the \-vm option to work.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1938 You can get a list of available cards when you run this option with \-v.
12867
e481fece8971 -adapters only works with directx
attila
parents: 12862
diff changeset
1939 Works currently only with \-vo directx.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1940 .
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1941 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1942 .B \-bpp <depth>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1943 Override the autodetected color depth.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1944 Only supported by the fbdev, dga, svga, vesa video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1945 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1946 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1947 .B \-brightness <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1948 Adjust the brightness of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1949 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1950 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1951 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1952 .B \-contrast <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1953 Adjust the contrast of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1954 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1955 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1956 .TP
12013
d0a1e865c1af -vo directfb options by Jiri Svoboda
diego
parents: 11993
diff changeset
1957 .B \-dfbopts <value> (\-vo directfb only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1958 Specify a parameter list for the directfb video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1959 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1960 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1961 .B \-display <name> (X11 only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1962 Specify the hostname and display number of the X server you want to display
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1963 on.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1964 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1965 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1966 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1967 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1968 \-display xtest.localdomain:0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1969 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1970 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1971 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1972 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1973 .B \-dr \ \ \
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1974 Turns on direct rendering (not supported by all codecs and video outputs)
13040
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1975 .br
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1976 .I WARNING:
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1977 May cause OSD/\:SUB corruption!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1978 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1979 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1980 .B \-dxr2 <option1:option2:...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1981 This option is used to control the dxr2 video output driver.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1982 .RSs
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1983 .IPs ar-mode=<value>
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
1984 aspect ratio mode (0 = normal, 1 = pan-and-scan, 2 = letterbox (default))
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1985 .IPs iec958-encoded
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1986 Set iec958 output mode to encoded.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1987 .IPs iec958-decoded
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1988 Set iec958 output mode to decoded (default).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1989 .IPs macrovision=<value>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1990 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1991 3 = agc 4 colorstripe)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1992 .IPs mute\
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1993 mute sound output
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1994 .IPs unmute
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1995 unmute sound output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1996 .IPs ucode=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1997 path to the microcode
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1998 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1999 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2000 .sp 1
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2001 .I TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2002 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2003 .RSs
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2004 .IPs 75ire
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2005 enable 7.5 IRE output mode
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2006 .IPs no75ire
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2007 disable 7.5 IRE output mode (default)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2008 .IPs bw\ \ \
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2009 b/\:w TV output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2010 .IPs color
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2011 color TV output (default)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2012 .IPs interlaced
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2013 interlaced TV output (default)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2014 .IPs nointerlaced
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2015 disable interlaced TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2016 .IPs norm=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2017 TV norm (ntsc (default), pal, pal60, palm, paln, palnc)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2018 .IPs square-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2019 set pixel mode to square
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2020 .IPs ccir601-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2021 set pixel mode to ccir601
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2022 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2023 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2024 .sp 1
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2025 .I overlay
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2026 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2027 .RSs
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2028 .IPs cr-left=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2029 Set the left cropping value (default: 50).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2030 .IPs cr-right=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2031 Set the right cropping value (default: 300).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2032 .IPs cr-top=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2033 Set the top cropping value (default: 0).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2034 .IPs cr-bottom=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2035 Set the bottom cropping value (default: 0).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2036 .IPs ck-[r|g|b]=<0\-255>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2037 Set the r(ed), g(reen) or b(lue) gain of the overlay color-key.
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2038 .IPs ck-[r|g|b]min=<0\-255>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2039 minimum value for the respective color key
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2040 .IPs ck-[r|g|b]max=<0\-255>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2041 maximum value for the respective color key
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2042 .IPs ignore-cache
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2043 Ignore cached overlay settings.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2044 .IPs update-cache
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2045 Update cached overlay settings.
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2046 .IPs ol-osd
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2047 Enable overlay onscreen display.
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2048 .IPs nool-osd
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2049 Disable overlay onscreen display (default).
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2050 .IPs ol[h|w|x|y]-cor=<-20\-20>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2051 Adjust the overlay size (h,w) and position (x,y) in case it does not
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2052 match the window perfectly (default: 0).
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2053 .IPs overlay
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2054 Activate overlay (default).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2055 .IPs nooverlay
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2056 Activate TVout.
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2057 .IPs overlay-ratio=<1\-2500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2058 Tune the overlay (default: 1000).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2059 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2060 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
2061 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2062 .B \-fb <device> (\-vo fbdev or directfb only) (OBSOLETE)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2063 Specifies the framebuffer device to use (default: /dev/\:fb0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2064 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2065 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2066 .B \-fbmode <modename> (\-vo fbdev only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2067 Change video mode to the one that is labeled as <modename> in
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2068 /etc/\:fb.modes.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2069 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2070 .I NOTE:
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2071 VESA framebuffer doesn't support mode changing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2072 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2073 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2074 .B \-fbmodeconfig <filename> (\-vo fbdev only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2075 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2076 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2077 .TP
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2078 .B \-forcexv (\-vo sdl only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2079 Force using XVideo through the sdl video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2080 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2081 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2082 .B \-fs (also see \-zoom)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2083 Fullscreen playback (centers movie, and paints black bands around it).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2084 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2085 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2086 .TP
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
2087 .B \-fsmode-dontuse <0\-31> (OBSOLETE, use the \-fs option)
6071
506212428423 added new description, new vop options and fsmode-dontuse
jonas
parents: 6023
diff changeset
2088 Try this option if you still experience fullscreen problems.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2089 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2090 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2091 .B \-fstype <type1,type2,...> (X11 only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2092 Specify a priority list of fullscreen modes to be used.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2093 You can negate the modes by prefixing them with '\-'.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2094 If you experience problems like the fullscreen window being covered
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2095 by other windows try using a different order.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2096 .br
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2097 .I NOTE:
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2098 See \-fstype help for a full list of available modes.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2099 .sp 1
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2100 The available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2101 .sp 1
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2102 .PD 0
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
2103 .RSs
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2104 .IPs above
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2105 Use the _NETWM_STATE_ABOVE hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2106 .IPs below
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2107 Use the _NETWM_STATE_BELOW hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2108 .IPs fullscreen
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2109 Use the _NETWM_STATE_FULLSCREEN hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2110 .IPs layer
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2111 Use the _WIN_LAYER hint with the default layer.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
2112 .IPs layer=<0...15>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2113 Use the _WIN_LAYER hint with the given layer number.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2114 .IPs netwm
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2115 Force NETWM style.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2116 .IPs none\
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2117 Do not set fullscreen window layer.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2118 .IPs stays_on_top
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2119 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2120 .REss
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2121 .sp 1
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2122 .RS
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2123 .I EXAMPLE:
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2124 .RE
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2125 .PD 0
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2126 .RSs
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2127 .IPs layer,stays_on_top,above,fullscreen
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2128 Default order, will be used as a fallback if incorrect or
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2129 unsupported modes are specified.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2130 .IPs \-fullscreen
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2131 Fixes fullscreen switching on OpenBox 1.x.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2132 .RE
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2133 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2134 .
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
2135 .TP
8745
93f78fb709e6 Added support for X style -geometry options (adapted from Henk's patch)
mark
parents: 8708
diff changeset
2136 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2137 Adjust where the output is on the screen initially.
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2138 The x and y specifications are in pixels measured from the top-left of the
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2139 screen to the top-left of the image being displayed, however if a percentage
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2140 sign is given after the argument it turns the value into a percentage of the
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
2141 screen size in that direction.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2142 It also supports the standard X11 \-geometry option format.
14207
f8670fdf6ab1 added -wid support for vo_directx.
joey
parents: 14205
diff changeset
2143 If an external window is specified using the \-wid option, then the x and
f8670fdf6ab1 added -wid support for vo_directx.
joey
parents: 14205
diff changeset
2144 y coordinates are relative to the top-left corner of the window rather
f8670fdf6ab1 added -wid support for vo_directx.
joey
parents: 14205
diff changeset
2145 than the screen.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2146 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2147 .I NOTE:
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2148 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2149 directx and tdfxfb video output drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2150 .sp 1
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2151 .I EXAMPLE:
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2152 .PD 0
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2153 .RSs
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2154 .IPs 50:40
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2155 Places the window at x=50, y=40.
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2156 .IPs 50%:50%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2157 Places the window in the middle of the screen.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2158 .IPs 100%\
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2159 Places the window at the middle of the right edge of the screen.
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2160 .IPs 100%:100%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2161 Places the window at the bottom right corner of the screen.
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2162 .RE
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2163 .PD 1
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2164 .
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2165 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2166 .B \-guiwid <window\ ID> (also see \-wid) (GUI only)
9334
f6007efc714f spelling
diego
parents: 9314
diff changeset
2167 This tells the GUI to also use an X11 window and stick itself to the bottom
f6007efc714f spelling
diego
parents: 9314
diff changeset
2168 of the video, which is useful to embed a mini-GUI in a browser (with the
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
2169 MPlayer plugin for instance).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2170 .
9314
f38fe55d0e05 this patch adds the option -guiwid to gmplayer. I think its a more clean
arpi
parents: 9309
diff changeset
2171 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2172 .B \-hue <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2173 Adjust the hue of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2174 You can get a colored negative of the image with this option.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2175 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2176 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2177 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2178 .B \-monitor-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2179 Specify the dotclock or pixelclock range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2180 .
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2181 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2182 .B \-monitor-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2183 Specify the horizontal frequency range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2184 .
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2185 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2186 .B \-monitor-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2187 Specify the vertical frequency range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2188 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2189 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2190 .B \-monitoraspect <ratio> (also see \-aspect)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2191 Set the aspect ratio of your monitor or TV screen.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2192 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
2193 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2194 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2195 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2196 \-monitoraspect 4:3 or 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2197 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2198 \-monitoraspect 16:9 or 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2199 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2200 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2201 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2202 .TP
14069
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
2203 .B \-nodouble
14079
f60d6dee476b Better wording, better explain -nodouble.
diego
parents: 14077
diff changeset
2204 Disables double buffering, mostly for debugging purposes.
14069
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
2205 Double buffering fixes flicker by storing two frames in memory, and
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
2206 displaying one while decoding another.
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
2207 It can affect OSD negatively, but often removes OSD flickering.
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
2208 .
0091c036baee -double is now default, thus -nodouble needs to be documented instead.
diego
parents: 14024
diff changeset
2209 .TP
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2210 .B \-nograbpointer
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2211 Do not grab the mouse pointer after a video mode change (\-vm).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2212 Useful for multihead setups.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2213 .
8692
604f0cde816c X11 window aspect patch by Arnaud Boulan <boulan@iie.cnam.fr>
attila
parents: 8685
diff changeset
2214 .TP
12388
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
2215 .B \-nokeepaspect
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2216 Do not keep window aspect ratio when resizing windows.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2217 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2218 Furthermore under X11 your window manager has to honor window aspect hints.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2219 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2220 .TP
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2221 .B \-noxv (\-vo sdl only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2222 Disables using XVideo through the sdl video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2223 .
10991
e65b09eb0a2a sdl only -noxv
alex
parents: 10974
diff changeset
2224 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2225 .B \-ontop\
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2226 Makes the player window stay on top of other windows.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2227 Supported by video output drivers which use X11, except SDL,
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2228 as well as directx and gl2.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2229 .
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
2230 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
2231 .B \-panscan <0.0\-1.0>
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
2232 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2233 movie to make it fit a 4:3 display without black bands).
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
2234 The range controls how much of the image is cropped.
13797
f84eeb35e13a panscan now supported in vo_quartz
nplourde
parents: 13794
diff changeset
2235 Only works with the xv, xmga, mga, gl, quartz and xvidix video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2236 .
6330
68a3003b57ce panscan added
gabucino
parents: 6326
diff changeset
2237 .TP
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2238 .B \-refreshrate <Hz>
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2239 Set the monitor refreshrate in Hz.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2240 Currently only supported by \-vo directx combined with the \-vm option.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2241 .
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2242 .TP
13005
8d37cc41a272 -rootwin is no longer X11 only.
diego
parents: 13002
diff changeset
2243 .B \-rootwin
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2244 Play movie in the root window (desktop background).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2245 Desktop background images may cover the movie window, though.
13090
0c37bcfc5ef0 added -rootwin support to vo_directx
joey
parents: 13088
diff changeset
2246 Only works with the x11, xv, xmga, xvidix, quartz and directx video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2247 .
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2248 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2249 .B \-saturation <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2250 Adjust the saturation of the video signal (default: 0).
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2251 You can get grayscale output with this option.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2252 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2253 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2254 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2255 .B \-screenh <pixels>
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2256 Specify the vertical screen resolution for video output drivers which
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2257 do not know the screen resolution like fbdev, x11 and TVout.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2258 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2259 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2260 .B \-screenw <pixels>
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2261 Specify the horizontal screen resolution for video output drivers which
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2262 do not know the screen resolution like fbdev, x11 and TVout.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2263 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2264 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2265 .B \-stop-xscreensaver (X11 only)
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2266 Turns off xscreensaver at startup and turns it on again on exit.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2267 .
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2268 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2269 .B \-vm \ \ \
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2270 Try to change to a different video mode.
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2271 Supported by the dga, x11, xv, sdl and directx video output drivers.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2272 If used with the directx video output driver the \-screenw,
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2273 \-screenh, \-bpp and \-refreshrate options can be used to set
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2274 the new display mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2275 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2276 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2277 .B \-vsync \ \
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2278 Enables VBI for the vesa, dfbmga and svga video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2279 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2280 .TP
14234
b085c4d81b4b small improvements
diego
parents: 14217
diff changeset
2281 .B \-wid <window\ ID> (also see \-guiwid, \-geometry) (X11 and DirectX only)
14207
f8670fdf6ab1 added -wid support for vo_directx.
joey
parents: 14205
diff changeset
2282 This tells MPlayer to attach to an existing window.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2283 Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2284 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2285 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2286 .B \-xineramascreen <0\-...>
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2287 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2288 displays) this option tells MPlayer which screen to display movie on.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2289 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2290 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2291 .B \-z <0\-9> (\-vo png only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2292 Specifies the compression level of the png video output driver.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2293 0 is no compression, 9 is the maximum compression.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2294 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2295 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2296 .B \-zrbw (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2297 Display in black and white.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2298 For optimal performance, this can be combined with '\-lavdopts gray'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2299 .
7192
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2300 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2301 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2302 Select a part of the input image to display, multiple occurences
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2303 of this option switch on cinerama mode.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2304 In cinerama mode the movie is distributed over more than one TV
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2305 (or beamer) to create a larger image.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2306 Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2307 card should at least have a \-zrdev in addition to the \-zrcrop.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2308 For examples, see the output of \-zrhelp and the Zr section of the
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2309 documentation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2310 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2311 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2312 .B \-zrdev <device> (\-vo zr only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2313 Specify the device special file that belongs to your MJPEG card, by default
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2314 the zr video output driver takes the first v4l device it can find.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2315 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2316 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2317 .B \-zrfd (\-vo zr only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2318 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2319 happens if the hardware scaler can stretch the image to its original size.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2320 Use this option to force decimation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2321 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2322 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2323 .B \-zrhdec <1,2,4> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2324 Horizontal decimation: Ask the driver to send only every 2nd or 4th
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2325 line/\:pixel of the input image to the MJPEG card and use the scaler
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2326 of the MJPEG card to stretch the image to its original size.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2327 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2328 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2329 .B \-zrhelp (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2330 Display a list of all \-zr* options, their default values and a
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2331 cinerama mode example.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2332 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2333 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2334 .B \-zrnorm <norm> (\-vo zr only)
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2335 Specify the TV norm as PAL or NTSC (default: no change).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2336 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2337 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2338 .B \-zrquality <1\-20> (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2339 A number from 1 (best) to 20 (worst) representing the JPEG encoding quality.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2340 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2341 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2342 .B \-zrvdec <1,2,4> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2343 Vertical decimation: Ask the driver to send only every 2nd or 4th
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2344 line/\:pixel of the input image to the MJPEG card and use the scaler
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2345 of the MJPEG card to stretch the image to its original size.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2346 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2347 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2348 .B \-zrxdoff <x display offset> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2349 If the movie is smaller than the TV screen, this option specifies the x
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2350 offset from the upper-left corner of the TV screen (default: centered).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2351 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2352 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2353 .B \-zrydoff <y display offset> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2354 If the movie is smaller than the TV screen, this option specifies the y
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2355 offset from the upper-left corner of the TV screen (default: centered).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2356 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2357 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2358 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2359 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2360 Video output drivers are interfaces to different video output facilities.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2361 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2362 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2363 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2364 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2365 Specify a priority list of video output drivers to be used.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2366 .PP
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2367 If the list has a trailing ',' MPlayer will fall back on drivers not
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2368 contained in the list.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2369 Suboptions are optional and can mostly be omitted.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2370 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2371 .I NOTE:
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2372 See \-vo help for a list of compiled-in video output drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2373 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2374 .I EXAMPLE:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2375 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2376 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2377 .IPs "\-vo xmga,xv,"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2378 Try the Matrox X11 driver, then the Xv driver, then others.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2379 .IPs "\-vo directx:noaccel"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2380 Uses the DirectX driver with acceleration features turned off.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2381 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2382 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2383 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2384 Available video output drivers are:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2385 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2386 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2387 .B xv (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2388 Uses the XVideo extension of XFree86 4.x to enable hardware
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2389 accelerated playback.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2390 If you cannot use a hardware specific driver, this is probably
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2391 the best option.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2392 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2393 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2394 .IPs port=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2395 Select a specific XVideo port.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2396 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2397 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2398 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2399 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2400 .B x11 (X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2401 Shared memory video output driver without hardware acceleration that
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2402 works whenever X11 is present.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2403 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2404 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2405 .B xover (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2406 Adds X11 support to all overlay based video output drivers.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2407 Currently only supported by tdfx_vid.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2408 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2409 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2410 .IPs <vo_driver>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2411 Select the driver to use as source to overlay on top of X11.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2412 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2413 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2414 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2415 .TP
13562
e1f2be2e2dfe xvmc clarification
diego
parents: 13556
diff changeset
2416 .B xvmc (X11 with \-vc ffmpeg12mc only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2417 Video output driver that uses the XvMC (X Video Motion Compensation)
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
2418 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2419 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2420 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2421 .IPs benchmark
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2422 Disables image display.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2423 Necessary for proper benchmarking of drivers that change
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2424 image buffers on monitor retrace only (nVidia).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2425 .IPs queue
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2426 Queue frames for display to allow more parallel work of the video hardware.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2427 May add a small (not noticeable) constant A/\:V desync.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2428 .IPs sleep
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2429 Use sleep function while waiting for rendering to finish
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2430 (not recomended on Linux).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2431 .IPs wait\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2432 Do not use sleep function while waiting for rendering to finish
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2433 (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2434 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2435 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2436 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2437 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2438 .B dga (X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2439 Play video through the XFree86 Direct Graphics Access extension.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2440 Considered obsolete.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2441 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2442 .TP
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2443 .B sdl (also see \-forcexv, \-noxv) (SDL only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2444 Highly platform independent SDL (Simple Directmedia Layer) library
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2445 video output driver.
13274
c7408a0158cc MPlayer X11 options do not affect SDL.
diego
parents: 13273
diff changeset
2446 Since SDL uses its own X11 layer, MPlayer X11 options do not have
c7408a0158cc MPlayer X11 options do not affect SDL.
diego
parents: 13273
diff changeset
2447 any effect on SDL.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2448 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2449 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2450 .IPs <driver>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2451 Explicitly choose the SDL driver to use.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2452 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2453 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2454 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2455 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2456 .B vidix\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2457 VIDIX (VIDeo Interface for *niX) is an interface to the
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2458 video acceleration features of different graphics cards.
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2459 Very fast video output driver on cards that support it.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2460 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2461 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2462 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2463 Explicitly choose the VIDIX subdevice driver to use.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2464 Available subdevice drivers are cyberblade_vid, mach64_vid, mga_crtc2_vid,
13900
99b893f9fb67 Mention unichrome_vid in the list of VIDIX drivers
diego
parents: 13894
diff changeset
2465 mga_vid, nvidia_vid, pm3_vid, radeon_vid, rage128_vid, sis_vid and
99b893f9fb67 Mention unichrome_vid in the list of VIDIX drivers
diego
parents: 13894
diff changeset
2466 unichrome_vid.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2467 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2468 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2469 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2470 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2471 .B xvidix (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2472 X11 frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2473 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2474 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2475 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2476 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2477 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2478 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2479 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2480 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2481 .B cvidix\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2482 Generic and platform independent VIDIX frontend, can even run in a
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2483 textconsole with nVidia cards.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2484 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2485 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2486 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2487 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2488 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2489 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2490 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2491 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2492 .B winvidix (Windows only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2493 Windows frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2494 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2495 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2496 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2497 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2498 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2499 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2500 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2501 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2502 .B directx (Windows only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2503 Video output driver that uses the DirectX interface.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2504 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2505 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2506 .IPs noaccel
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2507 Turns off hardware acceleration.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2508 Try this option if you have display problems.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2509 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2510 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2511 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2512 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2513 .B quartz (Mac OS X only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2514 Mac OS X Quartz video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2515 Under some circumstances, it might be more efficient to force a
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2516 packed YUV output format, with e.g.\& \-vf format=yuy2.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2517 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2518 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2519 .IPs device_id=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2520 Choose the display device to use in fullscreen.
13789
0c11de3fb17a fs_res desc for vo_quartz
nplourde
parents: 13777
diff changeset
2521 .IPs fs_res=<width>:<height>
13790
92a9afe47452 better wording
diego
parents: 13789
diff changeset
2522 Specify the fullscreen resolution (useful on slow systems).
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2523 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2524 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2525 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2526 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2527 .B fbdev (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2528 Uses the kernel framebuffer to play video.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2529 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2530 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2531 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2532 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2533 name of the VIDIX subdevice if the device name starts with 'vidix'
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2534 (e.g.\& 'vidixsis_vid' for the sis driver).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2535 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2536 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2537 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2538 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2539 .B fbdev2 (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2540 Uses the kernel framebuffer to play video,
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2541 alternative implementation.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2542 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2543 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2544 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2545 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2546 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2547 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2548 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2549 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2550 .B vesa\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2551 Very general video output driver that should work on any VESA VBE 2.0
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2552 compatible card.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2553 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2554 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2555 .IPs dga\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2556 Turns on DGA mode.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2557 .IPs nodga
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2558 Turns off DGA mode.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2559 .IPs neotv_pal
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2560 Activate the NeoMagic TV out and set it to PAL norm.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2561 .IPs neotv_ntsc
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2562 Activate the NeoMagic TV out and set it to NTSC norm.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2563 .IPs vidix
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2564 Use the VIDIX driver.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2565 .IPs lvo:\ \ \
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2566 Activate the Linux Video Overlay on top of VESA mode.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2567 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2568 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2569 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2570 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2571 .B svga\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2572 Play video using the SVGA library.
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2573 .PD 0
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2574 .RSs
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2575 .IPs "<video mode>"
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2576 Specify video mode to use.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2577 The mode can be given in a <width>x<height>x<colors> format,
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2578 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2579 .IPs bbosd
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2580 Draw OSD into black bands below the movie (slower).
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2581 .IPs native
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2582 Use only native drawing functions.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2583 This avoids direct rendering, OSD and hardware acceleration.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2584 .IPs retrace
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2585 Force frame switch on vertical retrace.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2586 Usable only with \-double.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2587 It has the same effect as the \-vsync option.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2588 .IPs sq\ \ \
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2589 Try to select a video mode with square pixels.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2590 .IPs vidix
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2591 Use svga with VIDIX.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2592 .RE
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2593 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2594 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2595 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2596 .B gl\ \ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2597 OpenGL video output driver.
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2598 Simple version, video size must be smaller than
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2599 the maximum texture size of your OpenGL implementation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2600 Intended to work even with the most simple OpenGL implementations.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2601 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2602 .RSs
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2603 .IPs (no)manyfmts
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2604 Enables support for more (RGB and BGR) color formats.
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2605 Needs OpenGL version >= 1.2.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2606 .IPs slice-height=<0\-...>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2607 Number of lines copied to texture in one piece (default: 4).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2608 0 for whole image.
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2609 .IPs (no)osd
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
2610 Enable or disable support for OSD rendering via OpenGL (default: enabled).
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2611 Mostly for testing, you should use \-osdlevel 0 to disable OSD.
13660
b34c5aa5f798 OSD variant for vo_gl.c that behaves more like the one of other vos.
reimar
parents: 13654
diff changeset
2612 .IPs (no)scaled-osd
13698
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2613 Changes the way the OSD behaves when the size of the
13660
b34c5aa5f798 OSD variant for vo_gl.c that behaves more like the one of other vos.
reimar
parents: 13654
diff changeset
2614 window changes (default: disabled).
13698
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2615 When enabled behaves more like the other video output drivers,
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2616 which is better for fixed-size fonts.
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2617 Disabled looks much better with FreeType fonts and uses the
13660
b34c5aa5f798 OSD variant for vo_gl.c that behaves more like the one of other vos.
reimar
parents: 13654
diff changeset
2618 borders in fullscreen mode.
13601
da85ac96600e aspect scaling and panscan support for vo_gl.c
reimar
parents: 13590
diff changeset
2619 .IPs (no)aspect
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
2620 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
13601
da85ac96600e aspect scaling and panscan support for vo_gl.c
reimar
parents: 13590
diff changeset
2621 Disabling might increase speed.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2622 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2623 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2624 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2625 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2626 .B gl2\ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2627 OpenGL video output driver, second generation.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2628 Supports OSD and videos larger than the maximum texture size.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2629 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2630 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2631 .B null\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2632 Produces no video output.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2633 Useful for benchmarking.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2634 .
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2635 .TP
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2636 .B aa (also see \-aa*)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2637 ASCII art video output driver that works on a text console.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2638 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2639 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2640 .B caca\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2641 Color ASCII art video output driver that works on a text console.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2642 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2643 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2644 .B bl\ \ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2645 Video playback using the Blinkenlights UDP protocol.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2646 This driver is highly hardware specific.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2647 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2648 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2649 .IPs <subdevice>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2650 Explicitly choose the Blinkenlights subdevice driver to use.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2651 It's something like arcade:host=localhost:2323 or
13412
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
2652 hdl:file=name1,file=name2.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2653 You must specify a subdevice.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2654 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2655 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2656 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2657 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2658 .B ggi\ \ \ \
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2659 GGI graphics system video output driver
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2660 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2661 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2662 .IPs <driver>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2663 Explicitly choose the GGI driver to use.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2664 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2665 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2666 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2667 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2668 .B directfb
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2669 Play video using the DirectFB library.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2670 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2671 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2672 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2673 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2674 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2675 Double and triple buffering give best results if you want to avoid tearing issues.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2676 Triple buffering is more efficent than double buffering as it doesn't block MPlayer
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2677 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2678 Single buffering should be avoided (default: single).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2679 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2680 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2681 Valid values are top = top fields first, bottom = bottom fields first.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2682 This option doesn't have any effect on progressive film material
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2683 like most MPEG movies are.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2684 You need to enable this option if you have tearing issues/\:unsmooth
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2685 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2686 .IPs layer=N
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2687 Will force layer with ID N for playback (default: -1 - auto).
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2688 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2689 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2690 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2691 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2692 .B dfbmga\
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2693 Matrox G400/\:G450/\:G550 specific video output driver that uses the
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2694 DirectFB library to make use of special hardware features.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2695 Enables CRTC2 (second head), displaying video independently of the first head.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2696 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2697 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2698 .IPs (no)bes
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2699 Enable the use of the Matrox BES (backend scaler) (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2700 Gives very good results concerning speed and output quality as interpolated
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2701 picture processing is done in hardware.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2702 Works only on the primary head.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2703 .IPs (no)spic
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2704 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2705 .IPs (no)crtc2
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2706 Turn on TV-out on the second head (default: enabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2707 The output quality is amazing as it's a full interlaced picture
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2708 with proper sync to every odd/\:even field.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2709 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2710 Use the DirectFB instead of the MPlayer keyboard code (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2711 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2712 Double and triple buffering give best results if you want to avoid tearing issues.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2713 Triple buffering is more efficent than double buffering as it doesn't block MPlayer
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2714 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2715 Single buffering should be avoided (default: triple).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2716 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2717 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2718 Valid values are top = top fields first, bottom = bottom fields first.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2719 This option doesn't have any effect on progressive film material
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2720 like most MPEG movies are.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2721 You need to enable this option if you have tearing issues/\:unsmooth
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2722 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2723 .IPs tvnorm=pal|ntsc|auto
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2724 Will set the TV norm of the Matrox card without the need
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2725 for modifying /etc/\:directfbrc (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2726 Valid norms are pal = PAL, ntsc = NTSC.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2727 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2728 which norm to use by looking at the framerate of the movie.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2729 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2730 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2731 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2732 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2733 .B mga (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2734 Matrox specific video output driver that makes use of the YUV back
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2735 end scaler on Gxxx cards through a kernel module.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2736 If you have a Matrox card, this is the fastest option.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2737 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2738 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2739 .IPs <device>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2740 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2741 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2742 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2743 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2744 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2745 .B xmga (Linux, X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2746 The mga video output driver, running in an X11 window.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2747 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2748 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2749 .IPs <device>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2750 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2751 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2752 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2753 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2754 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2755 .B syncfb\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2756 Video output driver for the SyncFB kernel module, which provides
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2757 special hardware features of Matrox Gxxx cards like hardware
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2758 deinterlacing, scaling and synchronizing your video output to
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2759 the vertical retrace of your monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2760 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2761 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2762 .B 3dfx (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2763 3Dfx specific video output driver.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2764 This driver directly uses the 3Dfx hardware on top of X11.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2765 Only 16 bpp are supported.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2766 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2767 .
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2768 .TP
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2769 .B tdfxfb (Linux only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2770 This driver employs the tdfx framebuffer driver to play movies with
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2771 YUV acceleration on 3Dfx cards.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2772 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2773 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2774 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2775 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2776 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2777 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2778 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2779 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2780 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2781 .B tdfx_vid (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2782 3Dfx specific video output driver.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2783 This driver directly uses the tdfx_vid kernel module.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2784 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2785 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2786 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2787 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2788 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2789 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2790 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2791 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2792 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2793 .B dxr2 (also see \-dxr2) (DXR2 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2794 Creative DXR2 specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2795 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2796 .RSs
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2797 .IPs <vo_driver>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2798 Output video subdriver to use as overlay (x11, xv).
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2799 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2800 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2801 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2802 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2803 .B dxr3 (DXR3 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2804 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2805 Hollywood Plus) specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2806 Also see the lavc video filter.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2807 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2808 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2809 .IPs overlay
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2810 Activates the overlay instead of TVOut.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2811 .IPs prebuf
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2812 Turns on prebuffering.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2813 .IPs sync\
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2814 Will turn on the new sync-engine.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2815 .IPs norm=<norm>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2816 Specifies the TV norm.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2817 .RSss
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2818 0: Does not change current norm (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2819 .br
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2820 1: Auto-adjust using PAL/\:NTSC.
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2821 .br
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2822 2: Auto-adjust using PAL/\:PAL-60.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2823 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2824 3: PAL
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2825 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2826 4: PAL-60
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2827 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2828 5: NTSC
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2829 .REss
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2830 .IPs <0\-3>
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2831 Specifies the device number to use if you have more than one em8300 card.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2832 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2833 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2834 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2835 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2836 .B mpegpes (DVB only)
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2837 Video output driver for DVB cards that writes the output to an MPEG-PES file
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2838 if no DVB card is installed.
13049
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2839 .PD 0
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2840 .RSs
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2841 .IPs card=<1\-4>
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2842 Specifies the device number to use if you have more than one DVB output card
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2843 (V3 API only, such as 1.x.y series drivers).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2844 .IPs <filename>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2845 Allows specifying the output filename (default: ./grab.mpg).
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2846 .RE
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2847 .PD 1
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2848 .
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2849 .TP
13639
12028d59e650 10l to me, noticed by Torinthiel
diego
parents: 13638
diff changeset
2850 .B zr (also see \-zr* and \-zrhelp)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2851 Video output driver for a number of MJPEG capture/\:playback cards.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2852 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2853 .TP
13639
12028d59e650 10l to me, noticed by Torinthiel
diego
parents: 13638
diff changeset
2854 .B zr2 (also see the zrmjpeg video filter)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2855 Video output driver for a number of MJPEG capture/\:playback cards,
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2856 second generation.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2857 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2858 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2859 .IPs dev=<device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2860 Specifies the device to use.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2861 .IPs pal\ \
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2862 Activate PAL video norm.
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2863 .IPs secam
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2864 Activate SECAM video norm.
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2865 .IPs ntsc\
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2866 Activate NTSC video norm.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2867 .IPs prebuf
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2868 Activate prebuffering, not yet supported.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2869 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2870 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2871 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2872 .TP
13412
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
2873 .B md5sum\
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2874 Calculate MD5 sums of each frame and write them to a file.
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2875 Supports RGB24 and YV12 colorspaces.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2876 Useful for debugging.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2877 .PD 0
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2878 .RSs
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2879 .IPs outfile=<value>
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2880 Specify the output filename (default: ./md5sums).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2881 .RE
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2882 .PD 1
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2883 .
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2884 .TP
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2885 .B yuv4mpeg
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2886 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
14149
a46b8a75efe9 Clarify vo_yuv4mpeg filename handling.
diego
parents: 14146
diff changeset
2887 images and stores it in a file (default: ./stream.yuv).
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2888 The format is the same as the one employed by mjpegtools, so this is
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2889 useful if you want to process the video with the mjpegtools suite.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2890 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format.
14174
18d902312b20 Mention how to concatenate files with -vo yuv4mpeg and -fixed-vo.
diego
parents: 14166
diff changeset
2891 You can combine it with the \-fixed-vo option to concatenate files
18d902312b20 Mention how to concatenate files with -vo yuv4mpeg and -fixed-vo.
diego
parents: 14166
diff changeset
2892 with the same dimensions and fps value.
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2893 .PD 0
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2894 .RSs
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2895 .IPs interlaced
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2896 Write the output as interlaced frames, top field first.
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2897 .IPs interlaced_bf
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2898 Write the output as interlaced frames, bottom field first.
14095
367ba4601d47 Add a file= suboption to set output file.
reimar
parents: 14079
diff changeset
2899 .IPs file=<filename>
14149
a46b8a75efe9 Clarify vo_yuv4mpeg filename handling.
diego
parents: 14146
diff changeset
2900 Write the output to <filename> instead of the default stream.yuv.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2901 .REss
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2902 .PD 1
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2903 .RS
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2904 .sp 1
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2905 .I NOTE:
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
2906 If you don't specify any option the output is progressive
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
2907 (i.e.\& not interlaced).
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2908 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2909 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2910 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2911 .B gif89a\
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2912 Output each frame into a single animated GIF file in the current directory.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2913 It supports only RGB format with 24 bpp and the output is converted to 256
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2914 colors.
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2915 .PD 0
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2916 .RSs
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2917 .IPs <fps>
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2918 Float value to specify framerate (default: 5.0).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2919 .IPs <filename>
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2920 Specify the output filename (default: ./out.gif).
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2921 .REss
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2922 .PD 1
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2923 .RS
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2924 .sp 1
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2925 .I NOTE:
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2926 You must specify the framerate before the filename or the framerate will
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2927 be part of the filename.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2928 .sp 1
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2929 .I EXAMPLE:
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2930 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2931 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2932 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2933 mplayer video.nut \-vo gif89a:15.0:test.gif
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2934 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2935 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2936 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2937 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2938 .B jpeg\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2939 Output each frame into a JPEG file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2940 Each file takes the frame number padded with leading zeros as name.
13247
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2941 .PD 0
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2942 .RSs
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2943 .IPs [no]progressive
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2944 Specify standard or progressive JPEG (default: noprogressive).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2945 .IPs [no]baseline
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2946 Specify use of baseline or not (default: baseline).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2947 .IPs optimize=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2948 optimization factor (default: 100)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2949 .IPs smooth=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2950 smooth factor (default: 0)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2951 .IPs quality=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2952 quality factor (default: 75)
13432
ca0cf56c02d2 fixes, better wordings on the new portable anymap and md5sum video output
gpoirier
parents: 13431
diff changeset
2953 .IPs outdir=<dirname>
13452
c364b7c13dd8 Same wording of vo_jpeg's outdir option as vo_pnm's.
ivo
parents: 13446
diff changeset
2954 Specify the directory to save the JPEG files to (default: ./).
13494
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2955 .IPs subdirs=<prefix>
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2956 Create numbered subdirectories with the specified prefix to
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2957 save the files in instead of the current directory.
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2958 .IPs maxfiles=<value> (subdirs only)
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2959 Maximum number of files to be saved per subdirectory.
13247
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2960 Must be equal to or larger than 1 (default: 1000).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2961 .RE
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2962 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2963 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2964 .TP
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2965 .B pnm\ \ \ \
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2966 Output each frame into a PNM file in the current directory.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2967 Each file takes the frame number padded with leading zeros as name.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2968 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2969 Also see pnm(5), ppm(5) and pgm(5).
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2970 .PD 0
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2971 .RSs
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
2972 .IPs ppm\ \
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2973 Write PPM files (default).
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
2974 .IPs pgm\ \
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2975 Write PGM files.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2976 .IPs pgmyuv
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2977 Write PGMYUV files.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2978 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2979 bottom of the picture.
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
2980 .IPs raw\ \
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2981 Write PNM files in raw mode (default).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2982 .IPs ascii
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2983 Write PNM files in ASCII mode.
13432
ca0cf56c02d2 fixes, better wordings on the new portable anymap and md5sum video output
gpoirier
parents: 13431
diff changeset
2984 .IPs outdir=<dirname>
ca0cf56c02d2 fixes, better wordings on the new portable anymap and md5sum video output
gpoirier
parents: 13431
diff changeset
2985 Specify the directory to save the PNM files to (default: ./).
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2986 .IPs subdirs=<prefix>
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2987 Create numbered subdirectories with the specified prefix to
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2988 save the files in instead of the current directory.
13494
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2989 .IPs maxfiles=<value> (subdirs only)
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2990 Maximum number of files to be saved per subdirectory.
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2991 Must be equal to or larger than 1 (default: 1000).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2992 .RE
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2993 .PD 1
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2994 .
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2995 .TP
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2996 .B png (also see \-z)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2997 Output each frame into a PNG file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2998 Each file takes the frame number padded with leading zeros as name.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2999 24bpp RGB and BGR formats are supported.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3000 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
3001 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
3002 .B tga\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
3003 Output each frame into a Targa file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
3004 Each file takes the frame number padded with leading zeros as name.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3005 The purpose of this video output driver is to have a simple lossless
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
3006 image writer to use without any external library.
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3007 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3008 You can force a particular format with the format video filter.
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3009 .sp 1
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3010 .I EXAMPLE:
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
3011 .RE
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3012 .PD 0
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3013 .RSs
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
3014 mplayer video.nut \-vf format=bgr15 \-vo tga
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
3015 .RE
13319
1709e2449b64 hopefully last format correction regarding prior commit in video output drivers section
kraymer
parents: 13318
diff changeset
3016 .PD 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
3017 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
3018 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3019 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3020 .SH "DECODING/\:FILTERING OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3021 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3022 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
3023 .B \-ac <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3024 Specify a priority list of audio codecs to be used, according to their codec
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3025 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3026 Use a '-' before the codec name to omit it.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3027 If the list has a trailing ',' MPlayer will fall back on codecs not
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3028 contained in the list.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3029 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3030 .I NOTE:
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3031 See \-ac help for a full list of available codecs.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3032 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3033 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3034 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3035 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3036 .IPs "\-ac mp3acm"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3037 Force the l3codeca.acm MP3 codec.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3038 .IPs "\-ac mad,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3039 Try libmad first, then fall back on others.
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
3040 .IPs "\-ac hwac3,a52,"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3041 Try hardware AC3 passthrough, software AC3, then others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3042 .IPs "\-ac -ffmp3,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3043 Skip FFmpeg's MP3 decoder.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3044 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3045 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3046 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3047 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3048 .B \-af-adv <force=(0\-3):list=(filters)> (also see \-af)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3049 Specify advanced audio filter options:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3050 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3051 .IPs force=<0\-3>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3052 Forces the insertion of audio filters to one of the following:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3053 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3054 0: completely automatic filter insertion (default)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3055 .br
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3056 1: Optimize for accuracy.
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3057 .br
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3058 2: Optimize for speed.
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3059 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3060 3: Turn off automatic filter insertion.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3061 .REss
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3062 .IPs list=<filters>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3063 Same as \-af.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3064 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3065 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3066 .TP
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3067 .B \-afm <driver1,driver2,...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3068 Specify a priority list of audio codec families to be used, according
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3069 to their codec name in codecs.conf.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3070 Falls back on the default codecs if none of the given codec families work.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3071 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3072 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3073 See \-afm help for a full list of available codec families.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3074 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3075 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3076 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3077 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3078 .IPs "\-afm ffmpeg"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3079 Try FFmpeg's libavcodec codecs first.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3080 .IPs "\-afm acm,dshow"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3081 Try Win32 codecs first.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3082 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3083 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3084 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3085 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3086 .B \-aspect <ratio>
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3087 Override movie aspect ratio.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3088 It is autodetected for MPEG files, but it cannot be done for most AVI files.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3089 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3090 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3091 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3092 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3093 \-aspect 4:3 or \-aspect 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3094 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3095 \-aspect 16:9 or \-aspect 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3096 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3097 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3098 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3099 .TP
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
3100 .B \-noaspect
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
3101 Disable automatic movie aspect ratio compensation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3102 .
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
3103 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3104 .B \-flip \
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3105 Flip image upside-down.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3106 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3107 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3108 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3109 Specify libavcodec decoding parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3110 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3111 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3112 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3113 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3114 \-lavdopts bug=1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3115 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3116 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3117 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
3118 .RS
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3119 Available options are:
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
3120 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3121 .RSs
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3122 .IPs bug=<value>
14193
a3f9e4fc6fae Better -lavdopts option descriptions.
diego
parents: 14192
diff changeset
3123 Manually work around encoder bugs.
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
3124 .RSss
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3125 0: nothing
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3126 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3127 1: autodetect bugs (default)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3128 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3129 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3130 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3131 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3132 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3133 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3134 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3135 16 (mpeg4): padding bug (autodetected)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3136 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3137 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3138 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3139 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3140 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3141 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3142 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3143 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3144 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3145 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3146 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3147 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3148 .REss
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3149 .IPs debug=<value>
14193
a3f9e4fc6fae Better -lavdopts option descriptions.
diego
parents: 14192
diff changeset
3150 Display debugging information.
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3151 .RSss
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3152 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3153 0: disabled
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3154 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3155 1: picture info
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3156 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3157 2: rate control
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3158 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3159 4: bitstream
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3160 .br
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3161 8: macroblock (MB) type
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3162 .br
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
3163 16: quantization parameter (QP)
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3164 .br
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3165 32: motion vector
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3166 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3167 0x0040: motion vector visualization (use \-noslices)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3168 .br
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3169 0x0080: macroblock (MB) skip
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3170 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3171 0x0100: startcode
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3172 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3173 0x0200: PTS
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3174 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3175 0x0400: error resilience
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3176 .br
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3177 0x0800: memory management control operations (H.264)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3178 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3179 0x1000: bugs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3180 .REss
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3181 .IPs ec=<value>
14193
a3f9e4fc6fae Better -lavdopts option descriptions.
diego
parents: 14192
diff changeset
3182 Set error concealment strategy.
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3183 .RSss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3184 1: Use strong deblock filter for damaged MBs.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3185 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3186 2: iterative motion vector (MV) search (slow)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3187 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3188 3: all (default)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3189 .REss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3190 .IPs er=<value>
14193
a3f9e4fc6fae Better -lavdopts option descriptions.
diego
parents: 14192
diff changeset
3191 Set error resilience strategy.
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3192 .RSss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3193 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3194 0: disabled
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3195 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3196 1: careful (Should work with broken encoders.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3197 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3198 2: normal (default) (Works with compliant encoders.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3199 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3200 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3201 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3202 4: very aggressive
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3203 .REss
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3204 .IPs fast\
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3205 Enable optimizations which do not comply to the specification and might
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3206 potentially cause problems, like simpler dequantization, assuming use
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3207 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
3208 checks to detect damaged bitstreams.
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3209 .IPs gray\
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3210 grayscale only decoding (a bit faster than with color)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3211 .IPs "idct=<0\-99> (see \-lavcopts)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
3212 For best decoding quality use the same IDCT algorithm for decoding and encoding.
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3213 This may come at a price in accuracy, though.
14180
6f40d266143a added conditional lowres description
nicodvb
parents: 14174
diff changeset
3214 .IPs lowres=<number>[,<w>]
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
3215 Decode at lower resolutions.
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
3216 Low resolution decoding is not supported by all codecs, and it will
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
3217 often result in ugly artifacts.
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
3218 This is not a bug, but a side effect of not decoding at full resolution.
13476
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3219 .RSss
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3220 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3221 0: disabled
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3222 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3223 1: 1/2 resolution
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3224 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3225 2: 1/4 resolution
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3226 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3227 3: 1/8 resolution
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3228 .REss
14182
584551fb6586 Fix paragraph indentation.
diego
parents: 14180
diff changeset
3229 .RS
14180
6f40d266143a added conditional lowres description
nicodvb
parents: 14174
diff changeset
3230 If <w> is specified lowres decoding will be used only if the width of the
6f40d266143a added conditional lowres description
nicodvb
parents: 14174
diff changeset
3231 video is major than or equal to <w>.
14182
584551fb6586 Fix paragraph indentation.
diego
parents: 14180
diff changeset
3232 .RE
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
3233 .IPs "sb=<number> (MPEG-2 only)"
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3234 Skip the given number of macroblock rows at the bottom.
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
3235 .IPs "st=<number> (MPEG-2 only)"
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3236 Skip the given number of macroblock rows at the top.
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3237 .IPs vismv=<value>
14193
a3f9e4fc6fae Better -lavdopts option descriptions.
diego
parents: 14192
diff changeset
3238 Visualize motion vectors.
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3239 .RSss
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3240 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3241 0: disabled
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3242 .br
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3243 1: Visualize forward predicted MVs of P-frames.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3244 .br
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3245 2: Visualize forward predicted MVs of B-frames.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3246 .br
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3247 4: Visualize backward predicted MVs of B-frames.
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3248 .REss
13036
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
3249 .IPs vstats
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
3250 Prints some statistics and stores them in ./vstats_*.log.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3251 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3252 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3253 .TP
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3254 .B \-noslices
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3255 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3256 whole frame in a single run.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3257 May be faster or slower, depending on card/\:cache.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3258 It has effect only with libmpeg2 and libavcodec codecs.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3259 .
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3260 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3261 .B \-nosound
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3262 Do not play/\:encode sound.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
3263 Useful for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3264 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3265 .TP
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3266 .B \-novideo
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3267 Do not play/\:encode video.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3268 .
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3269 .TP
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
3270 .B \-oldpp <quality> (OpenDivX only) (OBSOLETE)
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3271 Use the opendivx postprocessing code instead of the internal one.
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 11251
diff changeset
3272 Superseded by \-pp, the internal postprocessing offers better
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3273 quality and performance.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3274 The valid range of \-oldpp values varies by codec, it is mostly
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3275 0\-6, where 0=disable, 6=slowest/\:best.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3276 .
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3277 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3278 .B \-pp <quality> (also see \-vf pp)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3279 Set the DLL postprocess level.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3280 This option is no longer usable with \-vf pp.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3281 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3282 The valid range of \-pp values varies by codec, it is mostly
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3283 0\-6, where 0=disable, 6=slowest/\:best.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3284 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3285 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3286 .B \-pphelp (also see \-vf pp)
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
3287 Show a summary about the available postprocess filters and their usage.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3288 .
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
3289 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
3290 .B \-ssf <mode>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
3291 Specifies software scaler parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3292 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3293 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3294 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3295 .RSs
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3296 \-vf scale \-ssf lgb=3.0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3297 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3298 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3299 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3300 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3301 .IPs lgb=<0\-100>
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3302 gaussian blur filter (luma)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3303 .IPs cgb=<0\-100>
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3304 gaussian blur filter (chroma)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3305 .IPs ls=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3306 sharpen filter (luma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3307 .IPs cs=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3308 sharpen filter (chroma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3309 .IPs chs=<h>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3310 chroma horizontal shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3311 .IPs cvs=<v>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3312 chroma vertical shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3313 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3314 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3315 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3316 .TP
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3317 .B \-stereo <mode>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3318 Select type of MP2/\:MP3 stereo output.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3319 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3320 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3321 .IPs 0
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3322 stereo
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3323 .IPs 1
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3324 left channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3325 .IPs 2
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3326 right channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3327 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3328 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3329 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3330 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3331 .B \-sws <software\ scaler\ type> (also see \-vf scale and \-zoom)
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3332 Specify the software scaler algorithm to be used with the \-zoom option.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3333 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3334 .sp 1
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3335 Available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3336 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3337 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3338 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3339 .IPs 0
13492
51c46db54bd2 Sws default setting correction, and random wordings
gpoirier
parents: 13487
diff changeset
3340 fast bilinear
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3341 .IPs 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3342 bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3343 .IPs 2
13492
51c46db54bd2 Sws default setting correction, and random wordings
gpoirier
parents: 13487
diff changeset
3344 bicubic (good quality) (default)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3345 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3346 experimental
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3347 .IPs 4
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3348 nearest neighbour (bad quality)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3349 .IPs 5
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3350 area
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3351 .IPs 6
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3352 luma bicubic / chroma bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3353 .IPs 7
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3354 gauss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3355 .IPs 8
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3356 sincR
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3357 .IPs 9
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3358 lanczos
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3359 .IPs 10
13373
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3360 natural bicubic spline
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3361 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3362 .PD 1
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3363 .sp 1
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3364 .RS
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3365 .I NOTE:
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3366 For \-sws\ 2 and 7, sharpness can be set with the scaling parameter
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3367 of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, the scaling
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3368 parameter specifies the filter length (1 \- 10).
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3369 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3370 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3371 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
3372 .B \-vc <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3373 Specify a priority list of video codecs to be used, according to their codec
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3374 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3375 Use a '-' before the codec name to omit it.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3376 If the list has a trailing ',' MPlayer will fall back on codecs not
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3377 contained in the list.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3378 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3379 .I NOTE:
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3380 See \-vc help for a full list of available codecs.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3381 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3382 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3383 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3384 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3385 .IPs "\-vc divx"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3386 Force Win32/\:VFW DivX codec, no fallback.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3387 .IPs "\-vc divx4,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3388 Try divx4linux codec first, then fall back on others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3389 .IPs "\-vc -divxds,-divx,"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3390 Skip Win32 DivX codecs.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3391 .IPs "\-vc ffmpeg12,mpeg12,"
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
3392 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3393 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3394 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3395 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3396 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3397 .B \-vfm <driver1,driver2,...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3398 Specify a priority list of video codec families to be used, according
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3399 to their names in codecs.conf.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3400 Falls back on the default codecs if none of the given codec families work.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3401 .br
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3402 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3403 See \-vfm help for a full list of available codec families.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3404 .sp 1
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3405 .I EXAMPLE:
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3406 .PD 0
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3407 .RSs
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3408 .IPs "\-vfm ffmpeg,dshow,vfw"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3409 Try the libavcodec, then Directshow, then VfW codecs and fall back
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3410 on others, if they do not work.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3411 .IPs "\-vfm xanim"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3412 Try XAnim codecs first.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3413 .RE
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3414 .PD 1
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3415 .
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3416 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
3417 .B \-x <x> (MPlayer only)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3418 Scale image to width <x> (if software/\:hardware scaling is available).
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
3419 Disables aspect calculations.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3420 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3421 .TP
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
3422 .B \-xvidopts <option1:option2:...>
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3423 Specify additional parameters when decoding with XviD.
13654
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3424 .br
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3425 .I NOTE:
13692
1d13a5d9c166 lavc is faster than XviD and thus recommended for decoding and PP.
diego
parents: 13691
diff changeset
3426 Since libavcodec is faster than XviD you might want to use the libavcodec
1d13a5d9c166 lavc is faster than XviD and thus recommended for decoding and PP.
diego
parents: 13691
diff changeset
3427 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
13654
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3428 .sp 1
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3429 XviD's internal postprocessing filters:
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3430 .PD 0
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3431 .RSs
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3432 .IPs deblock-chroma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3433 chroma deblock filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3434 .IPs deblock-luma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3435 luma deblock filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3436 .IPs dering-luma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3437 luma deringing filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3438 .IPs dering-chroma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3439 chroma deringing filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3440 .IPs filmeffect (also see \-vf noise)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3441 Adds artificial film grain to the video.
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3442 May increase perceived quality, while lowering true quality.
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3443 .RE
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3444 .sp 1
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3445 .RS
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3446 rendering methods:
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3447 .RE
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3448 .PD 0
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3449 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3450 .IPs dr2\ \
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3451 Activate direct rendering method 2.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3452 .IPs nodr2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3453 Deactivate direct rendering method 2.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3454 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3455 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3456 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3457 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3458 .B \-xy <value>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3459 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3460 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3461 .IPs value<=8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3462 Scale image by factor <value>.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3463 .IPs value>8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3464 Set width to value and calculate height to keep correct aspect ratio.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3465 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3466 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3467 .
6310
eda1e909a3bf -stop_xscreensaver option
diego
parents: 6268
diff changeset
3468 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
3469 .B \-y <y> (MPlayer only)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3470 Scale image to height <y> (if software/\:hardware scaling is available).
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
3471 Disables aspect calculations.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3472 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3473 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3474 .B \-zoom\ \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3475 Allow software scaling, where available.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3476 Can be used to force scaling with \-vf scale.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3477 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3478 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3479 \-vf scale will ignore \-x / \-y / \-xy / \-fs / \-aspect without
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3480 \-zoom.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3481 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3482 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3483 .
14192
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3484 .SH "AUDIO FILTERS"
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3485 Audio filters allow you to modify the audio stream and its properties.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3486 The syntax is:
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3487 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3488 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3489 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3490 Setup a chain of audio filters.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3491 .PP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3492 .I NOTE:
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3493 To get a full list of available audio filters, see \-af help.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3494 .PP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3495 Available filters are:
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3496 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3497 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3498 .B resample[=srate[:sloppy][:type]]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3499 Changes the sample rate of the audio stream to an integer srate in Hz.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3500 It only supports the 16-bit little-endian format.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3501 With MEncoder, you need to also use \-srate <srate>.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3502 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3503 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3504 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3505 Changes the sample rate of the audio stream to an integer srate in Hz.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3506 It only supports the 16-bit little-endian format.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3507 With MEncoder, you need to also use \-srate <srate>.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3508 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3509 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3510 .IPs srate
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3511 the output sample rate
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3512 .IPs length
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3513 length of the filter with respect to the lower sampling rate (default: 16)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3514 .IPs linear
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3515 if 1 then filters will be linearly interpolated between polyphase entries
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3516 .IPs count
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3517 log2 of the number of polyphase entries
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3518 (..., 10->1024, 11->2048, 12->4096, ...)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3519 (default: 10->1024)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3520 .IPs cutoff
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3521 cutoff frequency (0.0-1.0), default set depending upon filter length
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3522 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3523 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3524 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3525 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3526 .B sweep[=speed]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3527 sine sweep
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3528 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3529 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3530 .B hrtf\ \ \
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3531 Head-related transfer function: Converts multichannel audio to
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3532 2 channel output for headphones, preserving the spatiality of the sound.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3533 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3534 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3535 .B channels[=nch]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3536 Change the number of channels to nch output channels.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3537 If the number of output channels is bigger than the number of input channels
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3538 empty channels are inserted (except when mixing from mono to stereo, then
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3539 the mono channel is repeated in both of the output channels).
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3540 If the number of output channels is smaller than the number of input channels
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3541 the exceeding channels are truncated.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3542 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3543 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3544 .B format[=bps:f]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3545 Select the bytes per sample and the format used for output from the
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3546 filter layer.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3547 The option bps is an integer and denotes Bytes per sample.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3548 The format f is a string containing a concatenated mix of:
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3549 .br
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3550 alaw, mulaw or imaadpcm
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3551 .br
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3552 float or int
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3553 .br
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3554 unsigned or signed
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3555 .br
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3556 le or be (little- or big-endian)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3557 .br
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3558 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3559 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3560 .B volume[=v:sc]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3561 Select the output volume level.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3562 This filter is not reentrant and can therefore only be enabled once for every
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3563 audio stream.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3564 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3565 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3566 .IPs v
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3567 Sets the desired gain in dB for all channels in the stream
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3568 from -200dB to +60dB (where -200dB mutes the sound
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3569 completely and +60dB equals a gain of 1000).
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3570 .IPs sc
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3571 Enable soft clipping.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3572 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3573 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3574 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3575 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3576 .B pan[=n:l01:l02:...l10:l11:l12:...ln0:ln1:ln2:...]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3577 Mixes channels arbitrarily, see DOCS/\:HTML/\:en/\:audio.html for details.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3578 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3579 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3580 .IPs n
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3581 number of input channels (1\-6)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3582 .IPs lij
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3583 How much of input channel j is mixed into output channel i.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3584 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3585 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3586 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3587 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3588 .B sub[=fc:ch]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3589 Add subwoofer channel.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3590 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3591 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3592 .IPs fc
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3593 cutoff frequency for low-pass filter (20Hz to 300Hz) (default: 60Hz)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3594 .IPs ch
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3595 channel number for the sub-channel
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3596 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3597 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3598 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3599 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3600 .B surround[=d]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3601 Decoder for matrix encoded surround sound, works on many 2 channel files.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3602 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3603 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3604 .IPs d
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3605 delay time in ms for the rear speakers (0ms to 1000ms) (default: 15ms)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3606 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3607 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3608 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3609 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3610 .B delay[=ch1:ch2:...]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3611 Delays the sound output.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3612 Specify the delay separately for each channel in milliseconds (floating point
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3613 number between 0 and 1000).
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3614 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3615 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3616 .B export[=mmapped_file[:nsamples]]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3617 Exports the incoming signal to other processes using memory mapping (mmap()).
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3618 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3619 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3620 .IPs mmapped_file
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3621 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3622 .IPs nsamples
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3623 number of samples per channel (default: 512)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3624 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3625 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3626 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3627 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3628 .B extrastereo[=mul]
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3629 Increases the difference between left and right channels to add some
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3630 sort of "live" effect to playback.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3631 .PD 0
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3632 .RSs
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3633 .IPs mul\ \
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3634 difference coefficient (default: 2.5)
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3635 .RE
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3636 .PD 1
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3637 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3638 .TP
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3639 .B volnorm
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3640 Maximizes the volume without distorting the sound.
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3641 .
14217
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3642 .TP
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3643 .B ladspa=file:label[:controls...]
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3644 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3645 This filter is reentrant, so multiple LADSPA plugins can be used at once.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3646 .PD 0
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3647 .RSs
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3648 .IPs file\
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3649 Specifies the LADSPA plugin library file.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3650 If LADSPA_PATH is set, it searches for the specified file.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3651 If it is not set, you must supply a fully specified pathname.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3652 .IPs label
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3653 Specifies the filter within the library.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3654 Some libraries contain only one filter, but others contain many of them.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3655 Entering 'help' here, will list all available filters within the specified
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3656 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3657 .IPs controls
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3658 Controls are zero or more floating point values that determine the
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3659 behaviour of the loaded plugin (for example delay, threshold or gain).
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3660 In verbose mode (add -v to the MPlayer command line), all available controls
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3661 and their valid ranges are printed.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3662 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3663 .RE
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3664 .PD 1
5b5ebf93ec16 Adds support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
ivo
parents: 14207
diff changeset
3665 .
14192
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3666 .
52e75a1aef10 Created audio filters section to replace -af description.
diego
parents: 14182
diff changeset
3667 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3668 .SH "VIDEO FILTERS"
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3669 Video filters allow you to modify the video stream and its properties.
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3670 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3671 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3672 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3673 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3674 Setup a chain of video filters.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3675 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3676 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3677 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3678 Setup a chain of video filters, to be applied in
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3679 .B reverse
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3680 order.
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3681 Deprecated in favor of \-vf.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3682 .PP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3683 Many parameters are optional and set to default values if omitted.
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3684 To explicitly use a default value set a parameter to '-1'.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3685 Parameters w:h means width x height in pixels, x:y means x;y position counted
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3686 from the upper left corner of the bigger image.
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3687 .br
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3688 .I NOTE:
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3689 To get a full list of available video filters, see \-vf help.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3690 .sp 1
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3691 Filters are managed in lists.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3692 There are a few commands to manage the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3693 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3694 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3695 .B \-vf-add <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3696 Appends the filters given as arguments to the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3697 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3698 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3699 .B \-vf-pre <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3700 Prepends the filters given as arguments to the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3701 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3702 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3703 .B \-vf-del <index1[,index2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3704 Deletes the filters at the given indexes.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3705 Index numbers start at 0, negative numbers address the end of the
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3706 list (-1 is the last).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3707 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3708 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3709 .B \-vf-clr
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3710 Completely empties the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3711 .PP
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3712 With filters that support it, you can access parameters by their name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3713 .
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3714 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3715 .B \-vf <filter>=help
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3716 Prints the parameter names and parameter value ranges for a particular
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3717 filter.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3718 .
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3719 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3720 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3721 Sets a named parameter to the given value.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3722 Use on and off or yes and no to set flag parameters.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3723 .PP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3724 Available filters are:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3725 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3726 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3727 .B crop[=w:h:x:y]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3728 Crops the given part of the image and discards the rest.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3729 Useful to remove black bands from widescreen movies.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3730 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3731 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3732 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3733 Cropped width and height, defaults to original width and height.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3734 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3735 Position of the cropped picture, defaults to center.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3736 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3737 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3738 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3739 .TP
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3740 .B cropdetect[=limit:round]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3741 Calculates necessary cropping parameters and prints the recommended parameters
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3742 to stdout.
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3743 .PD 0
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3744 .RSs
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3745 .IPs limit
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3746 Threshold, which can be optionally specified from nothing (0) to
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3747 everything (255) (default: 24).
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3748 .br
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3749 .IPs round
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3750 Value which the width/\:height should be divisible by (default: 16).
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3751 The offset is automatically adjusted to center the video.
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3752 Use 2 to get only even dimensions (needed for 4:2:2 video).
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3753 16 is best when encoding to most video codecs.
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3754 .RE
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3755 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3756 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3757 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3758 .B rectangle[=w:h:x:y]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3759 The plugin responds to the input.conf directive 'change_rectangle'
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3760 that takes two parameters.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3761 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3762 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3763 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3764 width and height (default: -1, maximum possible width where boundaries
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3765 are still visible.)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3766 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3767 top left corner position (default: -1, uppermost leftmost)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3768 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3769 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3770 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3771 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3772 .B expand[=w:h:x:y:o]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3773 Expands (not scales) movie resolution to the given value and places the
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3774 unscaled original at coordinates x, y.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3775 Can be used for placing subtitles/\:OSD in the resulting black bands.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3776 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3777 .IPs w,h
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3778 Expanded width,height (default: original width,height).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3779 Negative values for w and h are treated as offsets to the original size.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3780 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3781 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3782 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3783 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3784 .IP expand=0:-50:0:0
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3785 Adds a 50 pixel border to the bottom of the picture.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3786 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3787 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3788 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3789 position of original image on the expanded image (default: center)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3790 .IPs o
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3791 OSD/\:subtitle rendering
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3792 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3793 0: disable (default)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3794 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3795 1: enable
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3796 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3797 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3798 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3799 .TP
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3800 .B flip (also see \-flip)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3801 Flips the image upside down.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3802 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3803 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3804 .B mirror\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3805 Mirrors the image on the Y axis.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3806 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3807 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3808 .B rotate[=<0\-7>]
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3809 Rotates the image by 90 degrees and optionally flips it.
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3810 For values between 4\-7 rotation is only done if the movie geometry is
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3811 portrait and not landscape.
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3812 .RSs
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3813 .IPs 0
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3814 Rotate by 90 degrees clockwise and flip.
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3815 .IPs 1
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3816 Rotate by 90 degrees clockwise.
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3817 .IPs 2
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3818 Rotate by 90 degrees counterclockwise.
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3819 .IPs 3
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3820 Rotate by 90 degrees counterclockwise and flip.
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
3821 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3822 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3823 .TP
13373
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3824 .B scale[=w:h[:interlaced[:chr_drop[:param[:param2[:presize]]]]]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3825 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3826 colorspace conversion (also see \-sws).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3827 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3828 .IPs <w>,<h>
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3829 scaled width/\:height (default: original width/\:height)
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3830 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3831 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3832 If \-zoom is used, and underlying filters (including libvo) are
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3833 incapable of scaling, it defaults to d_width/\:d_height!
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3834 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3835 0: scaled d_width/\:d_height
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3836 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3837 -1: original width/\:height
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3838 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3839 -2: Calculate w/\:h using the other dimension and the prescaled aspect ratio.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3840 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3841 -3: Calculate w/\:h using the other dimension and the original aspect ratio.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3842 .REss
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3843 .IPs <interlaced>
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3844 Toggle interlaced scaling.
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3845 .RSss
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3846 0: off (default)
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3847 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3848 1: on
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3849 .REss
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3850 .IPs <chr_drop>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3851 chroma skipping
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3852 .RSss
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3853 0: Use all available input lines for chroma.
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3854 .br
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3855 1: Use only every 2. input line for chroma.
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3856 .br
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3857 2: Use only every 4. input line for chroma.
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3858 .br
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3859 3: Use only every 8. input line for chroma.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3860 .REss
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3861 .IPs "<param>[:<param2>] (also see \-sws)"
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3862 Set some scaling parameters depending on the type of scaler selected
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3863 with \-sws.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3864 .RSss
13373
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3865 \-sws 2 (bicubic): B (blurring) and C (ringing)
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3866 .br
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3867 0.00:0.60 default
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3868 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3869 0.00:0.75 VirtualDubs "precise bicubic"
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3870 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3871 0.00:0.50 Catmull-Rom spline
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3872 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3873 0.33:0.33 Mitchell-Netravali spline
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3874 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3875 1.00:0.00 cubic B-spline
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3876 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3877 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3878 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3879 \-sws 9 (lanczos): filter length (1\-10)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3880 .REss
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3881 .IPs <presize>
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3882 Scale to preset sizes.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3883 .RSss
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3884 qntsc: 352x240 (NTSC quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3885 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3886 qpal: 352x288 (PAL quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3887 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3888 ntsc: 720x480 (standard NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3889 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3890 pal: 720x576 (standard PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3891 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3892 sntsc: 640x480 (square pixel NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3893 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3894 spal: 768x576 (square pixel PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3895 .REss
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3896 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3897 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3898 .TP
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3899 .B dsize=[aspect|w:h]
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3900 Changes the intended display size/\:aspect at an arbitrary point in the
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3901 filter chain.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3902 Aspect can be given as a fraction (4/\:3) or floating point number
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3903 (1.33).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3904 Alternatively, you may specify the exact display width and height
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3905 desired.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3906 Note that this filter does NOT do any scaling itself; it just affects
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3907 what later scalers (software or hardware) will do when auto-scaling to
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3908 correct aspect.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3909 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3910 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3911 .B yuy2\ \ \
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3912 Forces software YV12/\:I420/\:422P to YUY2 conversion.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3913 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3914 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3915 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3916 .B yvu9\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3917 Forces software YVU9 to YV12 colorspace conversion.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3918 Deprecated in favor of the software scaler.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3919 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3920 .TP
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3921 .B yuvcsp\
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3922 Clamps YUV color values to the CCIR 601 range without doing real conversion.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3923 .
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3924 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3925 .B rgb2bgr[=swap]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3926 RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3927 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3928 .RSs
12559
diego
parents: 12558
diff changeset
3929 .IPs swap\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3930 Also perform R <\-> B swapping.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3931 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3932 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3933 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3934 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3935 .B palette
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3936 RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3937 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3938 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3939 .B format[=fourcc]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3940 Restricts the colorspace for the next filter without doing any conversion.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3941 Use together with the scale filter for a real conversion.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3942 .br
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3943 .I NOTE:
11313
b4fad475a89d Add -vf format=fmt=help hint.
diego
parents: 11302
diff changeset
3944 For a list of available formats see format=fmt=help.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3945 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3946 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3947 .IPs fourcc
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3948 format name like rgb15, bgr24, yv12, etc (default: yuy2)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3949 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3950 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3951 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3952 .TP
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3953 .B noformat[=fourcc]
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3954 Restricts the colorspace for the next filter without doing any conversion.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3955 Unlike the format filter, this will allow any colorspace
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3956 .B except
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3957 the one you specify.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3958 .br
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3959 .I NOTE:
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3960 For a list of available formats see noformat=fmt=help.
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3961 .PD 0
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3962 .RSs
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3963 .IPs fourcc
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3964 format name like rgb15, bgr24, yv12, etc (default: yv12)
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3965 .RE
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3966 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3967 .
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3968 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3969 .B pp[=filter1[:option1[:option2...]]/\:[-]filter2...] (also see \-pphelp)
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3970 Enables the specified chain of postprocessing subfilters.
13412
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
3971 Subfilters must be separated by '/' and can be disabled by
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
3972 prepending a '\-'.
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
3973 A subfilter's scope can be determined by appending a ':' followed
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
3974 by 'a', 'c' or 'y' (default: c):
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3975 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3976 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3977 .IPs a
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
3978 Automatically switch the subfilter off if the CPU is too slow.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3979 .IPs c
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3980 Do chrominance filtering, too.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3981 .IPs y
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3982 Do luminance filtering only (no chrominance).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3983 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3984 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3985 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3986 .RS
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3987 .br
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3988 .I NOTE:
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3989 \-pphelp shows a list of available subfilters.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3990 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3991 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3992 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3993 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3994 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3995 .IPs "\-vf pp=hb/vb/dr/al"
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3996 horizontal and vertical deblocking, deringing and automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3997 brightness/\:contrast
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3998 .IPs "\-vf pp=hb/vb/dr/al/lb"
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3999 horizontal and vertical deblocking, deringing, automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
4000 brightness/\:contrast and linear blend deinterlacer
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4001 .IPs "\-vf pp=de/-al"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4002 default filters without brightness/\:contrast correction
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4003 .IPs "\-vf pp=de/tn:1:2:3"
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
4004 Enable default filters & temporal denoiser.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4005 .IPs "\-vf pp=hb:y/vb:a"
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
4006 Horizontal deblocking on luminance only, and switch vertical deblocking
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
4007 on or off automatically depending on available CPU time.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4008 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4009 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4010 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4011 .TP
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
4012 .B spp[=quality[:qp[:mode]]]
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
4013 simple postprocessing filter
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
4014 .RSs
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
4015 .IPs quality
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
4016 0\-6 (default: 3)
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4017 .IPs qp\ \ \
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
4018 Force quantization parameter (default: 0, use QP from video).
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
4019 .IPs mode\ \ \
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
4020 0: hard thresholding (default)
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
4021 .br
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
4022 1: soft thresholding (better deringing, but blurrier)
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
4023 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4024 .
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
4025 .TP
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
4026 .B qp=equation
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
4027 quantization parameter (QP) change filter
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
4028 .RSs
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
4029 .IPs equation
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
4030 some equation like "2+2*sin(PI*qp)"
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
4031 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4032 .
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
4033 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4034 .B test\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4035 Generate various test patterns.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4036 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4037 .TP
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4038 .B rgbtest
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4039 Generate an RGB test pattern useful for detecting RGB vs BGR issues.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4040 You should see a red, green and blue stripe from top to bottom.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4041 .
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4042 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4043 .B lavc[=quality:fps]
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
4044 Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4045 Faster and of better quality than \-vf fame.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4046 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4047 .IPs quality
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4048 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4049 1\-31: fixed qscale
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4050 .br
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
4051 32\-: fixed bitrate in kBits
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4052 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4053 .IPs fps\ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4054 force output fps (float value) (default: 0, autodetect based on height)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4055 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4056 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4057 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4058 .B fame\ \ \
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
4059 Fast software YV12 to MPEG-1 conversion with libfame for use with DVB/\:DXR3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4060 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4061 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4062 .B dvbscale[=aspect]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4063 Set up optimal scaling for DVB cards, scaling the x axis in hardware and
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4064 calculating the y axis scaling in software to keep aspect.
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4065 Only useful together with expand and scale.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4066 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4067 .IPs aspect
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4068 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4069 576*4/\:3=768), set it to 576*(16/\:9)=1024 for a 16:9 TV.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4070 .RE
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4071 .sp 1
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4072 .RS
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4073 .I EXAMPLE:
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4074 .RE
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4075 .PD 0
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4076 .RSs
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4077 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc"
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4078 FIXME: Explain what this does.
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4079 .RE
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4080 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4081 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4082 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4083 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4084 Adds noise.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4085 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4086 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4087 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4088 luma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4089 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4090 chroma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4091 .IPs u
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4092 uniform noise (gaussian otherwise)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4093 .IPs t
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4094 temporal noise (noise pattern changes between frames)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4095 .IPs a
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4096 averaged temporal noise (smoother, but a lot slower)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4097 .IPs h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4098 high quality (slightly better looking, slightly slower)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4099 .IPs p
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4100 mix random noise with a (semi)regular pattern
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4101 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4102 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4103 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4104 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4105 .B denoise3d[=luma:chroma:time]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4106 This filter aims to reduce image noise producing smooth images and making still
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4107 images really still (This should enhance compressibility.).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4108 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4109 .RSs
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
4110 .IPs luma\
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4111 spatial luma strength (default: 4)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4112 .IPs chroma
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4113 spatial chroma strength (default: 3)
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
4114 .IPs time\
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4115 temporal strength (default: 6)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4116 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4117 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4118 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4119 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4120 .B hqdn3d[=luma:chroma:time]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4121 High precision/\:quality version of the denoise3d filter.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4122 Parameters and usage are the same.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4123 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4124 .TP
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4125 .B eq[=brightness:contrast] (OBSOLETE)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4126 Software equalizer with interactive controls just like the hardware
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4127 equalizer, for cards/\:drivers that do not support brightness and
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4128 contrast controls in hardware.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4129 Initial values in the range -100 \- 100 may be given on the command line.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4130 Might also be useful with MEncoder, either for fixing poorly captured
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4131 movies, or for slightly reducing contrast to mask artifacts and get by
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4132 with lower bitrates.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4133 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4134 .TP
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
4135 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4136 Alternative software equalizer that uses lookup tables (very slow),
11103
c934dadd77c2 -vf eq only supports brightness and contrast, noticed by Torinthiel.
diego
parents: 11095
diff changeset
4137 allowing gamma correction in addition to simple brightness
c934dadd77c2 -vf eq only supports brightness and contrast, noticed by Torinthiel.
diego
parents: 11095
diff changeset
4138 and contrast adjustment.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4139 Note that it uses the same MMX optimized code as \-vf eq if all
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4140 gamma values are 1.0.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4141 The parameters are given as floating point values.
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
4142 .PD 0
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4143 .RSs
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4144 .IPs rg
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4145 gamma value for the red component
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4146 .IPs gg
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4147 gamma value for the green component
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4148 .IPs bg
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
4149 gamma value for the blue component
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
4150 .REss
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
4151 .PD 1
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
4152 .RS
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4153 Parameters rg, gg, bg are the independent gamma values for the red, green
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4154 and blue components.
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
4155 The weight parameter can be used to reduce the effect of a high gamma value on
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4156 bright image areas, e.g.\& keep them from getting overamplified and just plain
11609
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
4157 white.
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
4158 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
4159 at its full strength.
11424
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
4160 Defaults are gamma=1.0, contrast=1.0, brightness=0.0, saturation=1.0,
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
4161 weight=1.0.
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4162 Value ranges are 0.1\-10 for gamma, -2\-2 for contrast (negative values result
11424
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
4163 in a negative image), -1\-1 for brightness, 0\-3 for saturation and 0\-1 for
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
4164 weight.
14143
9e3c885b72be Some fixes and better wording, remove alsa9 and alsa1x audio output drivers
diego
parents: 14097
diff changeset
4165 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4166 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4167 .TP
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4168 .B hue[=hue:saturation]
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4169 Defaults are hue=0.0, saturation=1.0.
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4170 Value ranges are -180\-180 for hue, -2\-2 for saturation (negative values result
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
4171 in a negative chroma).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4172 .
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4173 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4174 .B halfpack[=f]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4175 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4176 keeping all chroma samples.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4177 Useful for output to low-resolution display devices when hardware downscaling
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4178 is poor quality or is not available.
13273
ae21b81533bb spelling
diego
parents: 13270
diff changeset
4179 Can also be used as a primitive luma-only deinterlacer with very low CPU
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4180 usage.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4181 By default, halfpack averages pairs of lines when downsampling.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4182 The optional parameter f can be 0 to only use even lines, or 1 to only use
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4183 odd lines.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4184 Any other value for f gives the default (averaging) behavior.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4185 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4186 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
4187 .B ilpack[=mode]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4188 When interlaced video is stored in YUV 4:2:0 formats, chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4189 interlacing does not line up properly due to vertical downsampling of
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4190 the chroma channels.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4191 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4192 the chroma lines in their proper locations, so that in any given
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4193 scanline, the luma and chroma data both come from the same field.
11644
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
4194 The optional argument selects the sampling mode.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
4195 By default, linear interpolation (mode 1) is used.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
4196 Mode 0 uses nearest-neighbor sampling, which is fast but incorrect.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4197 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4198 .TP
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4199 .B harddup
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4200 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4201 If harddup is used when encoding, it will force duplicate frames to be
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4202 encoded in the output.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4203 This uses slightly more space, but is necessary for output to MPEG
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4204 files or if you plan to demux and remux the video stream after
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4205 encoding.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4206 Should be placed at or near the end of the filter chain unless you
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4207 have a good reason to do otherwise.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4208 .
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4209 .TP
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4210 .B softskip
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4211 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4212 Softskip moves the frame skipping (dropping) step of encoding from
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4213 before the filter chain to some point during the filter chain.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4214 This allows filters which need to see all frames (inverse telecine,
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4215 temporal denoising, etc.) to function properly.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4216 Should be placed after the filters which need to see all frames and
12559
diego
parents: 12558
diff changeset
4217 before any subsequent filters that are CPU-intensive.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4218 .
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4219 .TP
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4220 .B decimate[=max:hi:lo:frac]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4221 Drops frames that do not differ greatly from the previous frame in
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4222 order to reduce framerate.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4223 The argument max (if positive) sets the maximum number of consecutive
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4224 frames which can be dropped, or (if negative) the minimum interval
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4225 between dropped frames.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4226 A frame is a candidate for dropping if no 8x8 region differs by more
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4227 than a threshold of hi, and if not more than frac portion (1 meaning
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4228 the whole image) differs by more than a threshold of lo.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4229 Values of hi and lo are for 8x8 pixel blocks and represent actual
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4230 pixel value differences, so a threshold of 64 corresponds to 1 unit of
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4231 difference for each pixel, or the same spread out differently over the
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4232 block.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4233 The main use of this filter is for very-low-bitrate encoding (e.g.\&
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4234 streaming over dialup modem), but it could in theory be used for
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4235 fixing movies that were inverse-telecined incorrectly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4236 .
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4237 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4238 .B dint[=sense:level]
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
4239 Detects and drops the first from a set of interlaced video frames.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4240 Values can be from 0.0 to 1.0 \- first (default 0.1) is relative difference
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4241 between neighbor pixels, second (default 0.15) is what part of image has to
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4242 be detected as interlaced to drop the frame.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4243 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4244 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4245 .B lavcdeint
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4246 libavcodec deinterlacing filter
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4247 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4248 .TP
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
4249 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4250 Donald Graft's adaptive kernel deinterlacer.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4251 Deinterlaces parts of a video if a configurable threshold is exceeded.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4252 .PD 0
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4253 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4254 .IPs "thresh (0 \- 255)"
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
4255 Threshold (default 10).
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4256 .IPs "map (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4257 Paint pixels which exceed the threshold white (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4258 .IPs "order (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4259 Swap fields if 1 (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4260 .IPs "sharp (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4261 Enable additional sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4262 .IPs "twoway (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4263 Enable twoway sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4264 .RE
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4265 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4266 .
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4267 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4268 .B unsharp=l|cWxH:amount[:l|cWxH:amount]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4269 unsharp mask / gaussian blur
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4270 .RSs
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4271 .IPs l\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4272 Apply effect on luma component.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4273 .IPs c\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4274 Apply effect on chroma components.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4275 .IPs <width>x<height>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4276 width and height of the matrix, odd sized in both directions
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4277 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4278 .IPs amount
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4279 Relative amount of sharpness/\:blur to add to the image
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4280 (a sane range should be -1.5\-1.5).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4281 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4282 <0: blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4283 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4284 >0: sharpen
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4285 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4286 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4287 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4288 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4289 .B swapuv\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4290 Swap U & V plane.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4291 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4292 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4293 .B il=[d|i][s][:[d|i][s]]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4294 (De)interleaves lines.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4295 The goal of this filter is to add the ability to process interlaced images
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4296 pre-field without deinterlacing them.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4297 You can filter your interlaced DVD and play it on a TV without breaking the
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4298 interlacing.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4299 While deinterlacing (with the postprocessing filter) removes interlacing
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4300 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4301 2 fields (so called half pictures), so you can process (filter) them
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4302 independently and then re-interleave them.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4303 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4304 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4305 .IPs d
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4306 deinterleave (placing one above the other)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4307 .IPs i
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4308 interleave
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4309 .IPs s
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4310 swap fields (exchange even & odd lines)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4311 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4312 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4313 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4314 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4315 .B fil=[i|d]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4316 (De)interleaves lines.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4317 This filter is very similar to the il filter but much faster, the main
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4318 disadvantage is that it does not always work.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4319 Especially if combined with other filters it may produce randomly messed
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4320 up images, so be happy if it works but don't complain if it doesn't for
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4321 your combination of filters.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4322 .PD 0
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4323 .RSs
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4324 .IPs d
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4325 Deinterleave fields, placing them side by side.
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4326 .IPs i
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4327 Interleave fields again (reversing the effect of fil=d).
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4328 .RE
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4329 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4330 .
11251
731652167590 -vf fil
michael
parents: 11247
diff changeset
4331 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4332 .B field[=n]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4333 Extracts a single field from an interlaced image using stride arithmetic
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4334 to avoid wasting CPU time.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4335 The optional argument n specifies whether to extract the even or the odd
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4336 field (depending on whether n is even or odd).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4337 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4338 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4339 .B detc[=var1=value2:var2=value2:...]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4340 Attempts to reverse the 'telecine' process to recover a clean,
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4341 non-interlaced stream at film framerate.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4342 This was the first and most primitive inverse telecine filter to be
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4343 added to MPlayer/\:MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4344 It works by latching onto the telecine 3:2 pattern and following it as
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4345 long as possible.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4346 This makes it suitable for perfectly-telecined material, even in the
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4347 presence of a fair degree of noise, but it will fail in the presence
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4348 of complex post-telecine edits.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4349 Development on this filter is no longer taking place, as ivtc, pullup,
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4350 and filmdint are better for most applications.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4351 The following arguments (see syntax above) may be used to control
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4352 detc's behavior:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4353 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4354 .IPs dr\ \ \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4355 Set the frame dropping mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4356 0 (default) means don't drop frames to maintain fixed output framerate.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4357 1 means always drop a frame when there have been no drops or telecine
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4358 merges in the past 5 frames.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4359 2 means always maintain exact 5:4 input to output frame ratio.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4360 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4361 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4362 Use mode 1 or 2 with MEncoder.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4363 .IPs am\ \ \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4364 Analysis mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4365 Available values are 0 (fixed pattern with initial frame number
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4366 specified by fr=#) and 1 (agressive search for telecine pattern).
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4367 Default is 1.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4368 .IPs fr\ \ \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4369 Set initial frame number in sequence.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4370 0\-2 are the three clean progressive frames; 3 and 4 are the two
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4371 interlaced frames.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4372 The default, -1, means 'not in telecine sequence'.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4373 The number specified here is the type for the imaginary previous
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4374 frame before the movie starts.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4375 .IPs "tr0, tr1, tr2, tr3"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4376 Threshold values to be used in certain modes.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4377 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4378 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4379 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4380 .B ivtc[=1]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4381 Experimental 'stateless' inverse telecine filter.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4382 Rather than trying to lock on to a pattern like the detc filter does,
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4383 ivtc makes its decisions independently for each frame.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4384 This will give much better results for material that has undergone
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4385 heavy editing after telecine was applied, but as a result it is not as
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4386 forgiving of noisy input, for example TV capture.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4387 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4388 detc filter, and should be used with MEncoder but not with MPlayer.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4389 As with detc, you must specify the correct output framerate (\-ofps
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4390 23.976) when using MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4391 Further development on ivtc has stopped, as the pullup and filmdint
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4392 filters appear to be much more accurate.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4393 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4394 .TP
13267
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4395 .B pullup[=jl:jr:jt:jb:sb:mp]\
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4396 Third-generation pulldown reversal (inverse telecine) filter,
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4397 capable of handling mixed hard-telecine, 24 fps progressive, and 30
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4398 fps progressive content.
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4399 The pullup filter is designed to be much more robust than detc or
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4400 ivtc, by taking advantage of future context in making its decisions.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4401 Like ivtc, pullup is stateless in the sense that it does not lock onto
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4402 a pattern to follow, but it instead looks forward to the following
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4403 fields in order to identify matches and rebuild progressive frames.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4404 It is still under development, but believed to be quite accurate.
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4405 The jl, jr, jt, and jb options set the amount of "junk" to ignore at
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4406 the left, right, top, and bottom of the image, respectively.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4407 Left/\:right are in units of 8 pixels, while top/\:bottom are in units of
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4408 2 lines.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4409 The default is 8 pixels on each side.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4410 Setting the sb (strict breaks) option to 1 will reduce the chances of
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4411 pullup generating an occasional mismatched frame, but it may also
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4412 cause an excessive number of frames to be dropped during high motion
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4413 sequences.
13267
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4414 Conversely, setting it to -1 will make pullup match fields more
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4415 easily.
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4416 This may help processing of video where there is slight blurring
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4417 between the fields, but may also cause there to be interlaced frames
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4418 in the output.
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4419 The mp (metric plane) option may be set to 1 or 2 to use a chroma
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4420 plane instead of the luma plane for doing pullup's computations.
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4421 This may improve accuracy on very clean source material, but more
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4422 likely will decrease accuracy, especially if there is chroma noise
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4423 (rainbow effect) or any grayscale video.
13273
ae21b81533bb spelling
diego
parents: 13270
diff changeset
4424 The main purpose of setting mp to a chroma plane is to reduce CPU load
13267
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4425 and make pullup usable in realtime on slow machines.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
4426 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4427 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4428 Always follow pullup with the softskip filter when encoding to ensure
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4429 that pullup is able to see each frame.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4430 Failure to do so will lead to incorrect output and will usually crash,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4431 due to design limitations in the codec/\:filter layer.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4432 .
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4433 .TP
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4434 .B filmdint[=options]
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4435 Inverse telecine filter, similar to the pullup filter above.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4436 It is designed to handle any pulldown pattern, including mixed soft and
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4437 hard telecine and limited support for movies that are slowed down or sped
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4438 up from their original framerate for TV.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4439 Only the luma plane is used to find the frame breaks.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4440 If a field has no match, it is deinterlaced with simple linear
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4441 approximation.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4442 If the source is MPEG-2, this must be the first filter to allow
11992
d8890a065727 vd_ffmpeg to set repeat-first-field patch by (Zoltan Hidvegi <mplayer at hzoli do 2y dot net>)
michael
parents: 11991
diff changeset
4443 access to the field-flags set by the MPEG-2 decoder.
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4444 Depending on the source MPEG, you may be fine ignoring this advice, as
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4445 long as you do not see lots of "Bottom-first field" warnings.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4446 With no options it does normal inverse telecine, and should be used
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4447 together with mencoder \-fps 29.97 \-ofps 23.976.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4448 When this filter is used with mplayer, it will result in an uneven
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4449 framerate during playback, but it is still generally better than using
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4450 pp=lb or no deinterlacing at all.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4451 Multiple options can be specified separated by /.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4452 .RSs
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4453 .IPs crop=w:h:x:y
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4454 Just like the crop filter, but faster, and works on mixed hard and soft
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4455 telecined content as well as when y is not a multiple of 4.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4456 If x or y would require cropping fractional pixels from the chroma
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4457 planes, the crop area is extended.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4458 This usually means that x and y must be even.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4459 .IPs io=ifps:ofps
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4460 For each ifps input frames the filter will output ofps frames.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4461 The ratio of ifps/\:ofps should match the \-fps/\-ofps ratio.
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4462 This could be used to filter movies that are broadcast on TV at a frame
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4463 rate different from their original framerate.
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4464 .IPs luma_only=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4465 If n is nonzero, the chroma plane is copied unchanged.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4466 This is useful for YV12 sampled TV, which discards one of the chroma
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4467 fields.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4468 .IPs mmx2=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4469 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4470 optimized functions, othewise, use plain C.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4471 If this option is not specified, MMX2 and 3DNow! are auto-detected, use
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4472 this option to override auto-detection.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4473 .IPs fast=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4474 The larger n will speed up the filter at the expense of accuracy.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4475 The default value is n=3.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4476 If n is odd, a frame immediately following a frame marked with the
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4477 REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4478 will not spend any time on soft-telecined MPEG-2 content.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4479 This is the only effect of this flag if MMX2 or 3DNow! is available.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4480 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
4481 as with n=2 or 3.
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4482 If n=2 or 3, the number of luma levels used to find the frame breaks is
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4483 reduced from 256 to 128, which results in a faster filter without losing
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4484 much accuracy.
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
4485 If n=4 or 5, a faster, but much less accurate metric will be used to
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4486 find the frame breaks, which is more likely to misdetect high vertical
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4487 detail as interlaced content.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4488 .IPs verbose=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4489 If n is nonzero, print the detailed metrics for each frame.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4490 Useful for debugging.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4491 .IPs dint_thres=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4492 Deinterlace threshold.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4493 Used during de-interlacing of unmatched frames.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4494 Larger value means less deinterlacing, use n=256 to completely turn off
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4495 deinterlacing.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4496 Default is n=8.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4497 .IPs comb_thres=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4498 Threshold for comparing a top and bottom fields.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4499 Defaults to 128.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4500 .IPs diff_thres=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4501 Threshold to detect temporal change of a field.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4502 Default is 128.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4503 .IPs sad_thres=n
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4504 Sum of Absolute Difference threshold, default is 64.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4505 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4506 .
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4507 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4508 .B softpulldown
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
4509 This filter works only correct with MEncoder and acts on the MPEG-2 flags
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4510 used for soft 3:2 pulldown (soft telecine).
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4511 If you want to use the ivtc or detc filter on movies that are partly soft
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4512 telecined, inserting this filter before them should make them more reliable.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4513 .
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4514 .TP
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4515 .B divtc[=options]
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4516 Inverse telecine for deinterlaced video.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4517 If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4518 using a method that keeps one field and interpolates the other, the result is
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4519 a juddering video that has every fourth frame duplicated.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4520 This filter is intended to find and drop those duplicates and restore the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4521 original film framerate.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4522 When using this filter, you must specify \-ofps that is 4/\:5 of the fps of the
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4523 input file (23.976 if the input is 29.97fps).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4524 The options are:
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4525 .RSs
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4526 .IPs pass=1|2
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4527 Use two-pass mode.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4528 This produces best results.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4529 Pass 1 analyzes the video and writes the results to a log file.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4530 Pass 2 then reads this log file and uses the information to do the actual work.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4531 Note that these passes do NOT correspond to pass 1 and 2 of the encoding
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4532 process.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4533 In order to use divtc two-pass with two-pass video encoding, you must perform
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4534 three passes: first divtc pass 1 and encoder pass 1, then divtc pass 2 and
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4535 encoder pass 1, and finally divtc pass 2 and encoder pass 2.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4536 .IPs file=filename
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4537 Set the 2-pass log filename (default: "framediff.log").
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4538 .IPs threshold=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4539 Set the minimum strength the telecine pattern must have for the filter to
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4540 believe in it (default: 0.5).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4541 This is used to avoid recognizing false pattern from the parts of the video
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4542 that are very dark or very still.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4543 .IPs window=numframes
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4544 Set the number of past frames to look at when searching for pattern
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4545 (default: 30).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4546 Longer window improves the reliability of the pattern search, but shorter
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4547 window improves the reaction time to the changes in the telecine phase.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4548 This only affects the one-pass mode.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4549 The two-pass mode currently uses fixed window that extends to both future
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4550 and past.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4551 .IPs phase=0|1|2|3|4
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4552 Sets the initial telecine phase for one-pass mode (default: 0).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4553 The two-pass mode can see the future, so it is able to use the correct
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4554 phase from the beginning, but one-pass mode can only guess.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4555 It catches the correct phase when it finds it, but this option can be used
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4556 to fix the possible juddering at the beginning.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4557 The first pass of the two-pass mode also uses this, so if you save the output
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4558 from the first pass, you get constant phase result.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4559 .IPs deghost=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4560 Set the deghosting threshold (0\-255 for one-pass mode, -255\-255 for two-pass
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4561 mode, default 0).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4562 If nonzero, deghosting mode is used.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4563 This is for video that has been deinterlaced by blending the fields
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4564 together instead of dropping one of the fields.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4565 Deghosting amplifies any compression artifacts in the blended frames, so the
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4566 parameter value is used as a threshold to exclude those pixels from
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4567 deghosting that differ from the previous frame less than specified value.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4568 If two-pass mode is used, then negative value can be used to make the
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4569 filter analyze the whole video in the beginning of pass-2 to determine
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4570 whether it needs deghosting or not and then select either zero or the
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4571 absolute value of the parameter.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4572 Specify this option for pass-2, it makes no difference on pass-1.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4573 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4574 .
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4575 .TP
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4576 .B phase=[t|b|p|a|u|T|B|A|U][:v]
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4577 Delay interlaced video by one field time so that the field order
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4578 changes.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4579 The intended use is to fix PAL movies that have been captured with the
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4580 opposite field order to the film-to-video transfer.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4581 The options are:
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4582 .RSs
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4583 .IPs t
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4584 Capture field order top-first, transfer bottom-first.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4585 Filter will delay the bottom field.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4586 .IPs b
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4587 Capture bottom-first, transfer top-first.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4588 Filter will delay the top field.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4589 .IPs p
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4590 Capture and transfer with the same field order.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4591 This mode only exists for the documentation of the other options to refer to,
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4592 but if you actually select it, the filter will faithfully do nothing ;-)
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4593 .IPs a
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4594 Capture field order determined automatically by field flags, transfer opposite.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4595 Filter selects among t and b modes on a frame by frame basis using field flags.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4596 If no field information is available, then this works just like u.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4597 .IPs u
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4598 Capture unknown or varying, transfer opposite.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4599 Filter selects among t and b on a frame by frame basis by analyzing the
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4600 images and selecting the alternative that produces best match between the
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4601 fields.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4602 .IPs T
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4603 Capture top-first, transfer unknown or varying.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4604 Filter selects among t and p using image analysis.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4605 .IPs B
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4606 Capture bottom-first, transfer unknown or varying.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4607 Filter selects among b and p using image analysis.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4608 .IPs A
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4609 Capture determined by field flags, transfer unknown or varying.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4610 Filter selects among t, b and p using field flags and image analysis.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4611 If no field information is available, then this works just like U.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4612 This is the default mode.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4613 .IPs U
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4614 Both capture and transfer unknown or varying.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4615 Filter selects among t, b and p using image analysis only.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4616 .IPs v
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4617 Verbose operation.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4618 Prints the selected mode for each frame and the average squared difference
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4619 between fields for t, b, and p alternatives.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4620 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4621 .
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4622 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4623 .B telecine[=start]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4624 Apply 3:2 'telecine' process to increase framerate by 20%.
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4625 This most likely will not work correctly with MPlayer, but it can
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4626 be used with 'mencoder \-fps 29.97 \-ofps 29.97 \-vf telecine'.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4627 Both fps options are essential!
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4628 (A/\:V sync will break if they are wrong.)
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4629 The optional start parameter tells the filter where in the telecine
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4630 pattern to start (0\-3).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4631 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4632 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4633 .B tinterlace[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4634 Temporal field interlacing \- merge pairs of frames into an interlaced
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4635 frame, halving the framerate.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4636 Even frames are moved into the upper field, odd frames to the lower field.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4637 This can be used to fully reverse the effect of the tfields filter (in mode 0).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4638 Available modes are:
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4639 .PD 0
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4640 .RSs
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4641 .IPs 0
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4642 Move odd frames into the upper field, even into the lower field, generating
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4643 a full-height frame at half framerate.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4644 .IPs 1
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4645 Only output odd frames, even frames are dropped; height unchanged.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4646 .IPs 2
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4647 Only output even frames, odd frames are dropped; height unchanged.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4648 .IPs 3
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4649 Expand each frame to full height, but pad alternate lines with black;
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4650 framerate unchanged.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4651 .RE
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4652 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4653 .
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4654 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4655 .B tfields[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4656 Temporal field separation \- split fields into frames, doubling the
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4657 output framerate.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4658 Like the telecine filter, tfields will only work properly with
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4659 MEncoder, and only if both \-fps and \-ofps are set to the
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4660 desired (double) framerate!
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4661 Available modes are:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4662 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4663 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4664 .IPs 0
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4665 Leave fields unchanged. (This will jump/\:flicker.)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4666 .IPs 1
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4667 Interpolate missing lines. (The algorithm used might not be so good.)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4668 .IPs 2
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4669 Translate fields by 1/4 pixel with linear interpolation (no jump).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4670 .IPs 4
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4671 Translate fields by 1/4 pixel with 4tap filter (higher quality).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4672 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4673 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4674 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4675 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4676 .B boxblur=radius:power[:radius:power]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4677 box blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4678 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4679 .RSs
13513
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4680 .IPs <radius>
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4681 blur filter strength
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4682 .IPs <power>
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4683 number of filter applications
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4684 .RE
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4685 .PD 1
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4686 .
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4687 .TP
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4688 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4689 shape adaptive blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4690 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4691 .RSs
13513
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4692 .IPs <radius>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4693 blur filter strength (~0.1\-4.0) (slower if larger)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4694 .IPs <pf>\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4695 prefilter strength (~0.1\-2.0)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4696 .IPs <colorDiff>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4697 maximum difference between pixels to still be considered (~0.1\-100.0)
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4698 .RE
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4699 .PD 1
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4700 .
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4701 .TP
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4702 .B smartblur=radius:strength:threshold[:radius:strength:threshold]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4703 smart blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4704 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4705 .RSs
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4706 .IPs <radius>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4707 blur filter strength (~0.1\-5.0) (slower if larger)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4708 .IPs <strength>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4709 blur (0.0\-1.0) or sharpen (-1.0\-0.0)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4710 .IPs <threshold>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4711 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4712 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4713 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4714 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4715 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4716 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4717 Correct the perspective of movies not filmed perpendicular to the screen.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4718 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4719 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4720 .IPs x0,y0,...
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4721 coordinates of the top left, top right, bottom left, bottom right corners
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4722 .IPs t\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4723 linear (0) or cubic resampling (1)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4724 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4725 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4726 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4727 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4728 .B 2xsai\ \
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4729 Scale and smooth the image with the 2x scale and interpolate algorithm.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4730 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4731 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4732 .B 1bpp\ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4733 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4734 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4735 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4736 .B down3dright[=lines]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4737 Reposition and resize stereoscopic images.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4738 Extracts both stereo fields and places them side by side, resizing
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4739 them to maintain the original movie aspect.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4740 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4741 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4742 .IPs lines
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4743 number of lines to select from the middle of the image (default: 12)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4744 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4745 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4746 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4747 .TP
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4748 .B bmovl=hidden:opaque:fifo
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4749 The bitmap overlay filter reads bitmaps from a FIFO and displays them
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4750 on top of the movie, allowing some transformations on the image.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4751 Also see TOOLS/bmovl-test.c for a small bmovl test program.
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4752 .PD 0
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4753 .RSs
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4754 .IPs <hidden>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4755 Set the default value of the 'hidden' flag (0=visible, 1=hidden).
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4756 .IPs <opaque>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4757 Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4758 .IPs <fifo>
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4759 path/\:filename for the FIFO (named pipe connecting mplayer \-vf bmovl to the
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4760 controlling application)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4761 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4762 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4763 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4764 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4765 FIFO commands are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4766 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4767 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4768 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4769 .IPs "RGBA32 width height xpos ypos alpha clear"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4770 followed by width*height*4 Bytes of raw RGBA32 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4771 .IPs "ABGR32 width height xpos ypos alpha clear"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4772 followed by width*height*4 Bytes of raw ABGR32 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4773 .IPs "RGB24 width height xpos ypos alpha clear"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4774 followed by width*height*3 Bytes of raw RGB24 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4775 .IPs "BGR24 width height xpos ypos alpha clear"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4776 followed by width*height*3 Bytes of raw BGR24 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4777 .IPs "ALPHA width height xpos ypos alpha"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4778 Change alpha transparency of the specified area.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4779 .IPs "CLEAR width height xpos ypos"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4780 Clear area.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4781 .IPs OPAQUE
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4782 Disable all alpha transparency.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4783 Send "ALPHA 0 0 0 0 0" to enable it again.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4784 .IPs HIDE\
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4785 Hide bitmap.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4786 .IPs SHOW\
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4787 Show bitmap.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4788 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4789 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4790 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4791 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4792 Arguments are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4793 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4794 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4795 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4796 .IPs "width, height"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4797 image/area size
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4798 .IPs "xpos, ypos"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4799 Start blitting at position x/y.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4800 .IPs alpha
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4801 Set alpha difference.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4802 If you set this to -255 you can then send a sequence of ALPHA-commands to set
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4803 the area to -225, -200, -175 etc for a nice fade-in-effect! ;)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4804 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4805 0: same as original
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4806 .br
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4807 255: Make everything opaque.
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4808 .br
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4809 -255: Make everything transparent.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4810 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4811 .IPs clear
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4812 Clear the framebuffer before blitting.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4813 .RSss
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4814 0: The image will just be blitted on top of the old one, so you do not need to
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4815 send 1.8MB of RGBA32 data every time a small part of the screen is updated.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4816 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4817 1: clear
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4818 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4819 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4820 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4821 .
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4822 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4823 .B framestep=I|[i]step
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4824 Renders only every nth frame or every Intra (key) frame.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4825 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4826 If you call the filter with I (uppercase) as the parameter, then ONLY
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4827 keyframes are rendered.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4828 For DVDs it generally means one in every 15/\:12 frames (IBBPBBPBBPBBPBB),
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4829 for AVI it means every scene change or every keyint value (see \-lavcopts
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4830 keyint= value if you use MEncoder to encode the video).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4831 .sp 1
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
4832 When a keyframe is found, an 'I!' string followed by a newline character is
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
4833 printed, leaving the current line of MPlayer/\:MEncoder output on the screen,
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4834 because it contains the time (in seconds) and frame number of the keyframe
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4835 (You can use this information to split the AVI.).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4836 .sp 1
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4837 If you call the filter with a numeric parameter 'step' then only one in
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4838 every 'step' frames is rendered.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4839 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4840 If you put an 'i' (lowercase) before the number then an I! is printed
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4841 (like the I parameter).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4842 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4843 If you give only the i then nothing is done to the frames, only I! is
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4844 printed.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4845 .
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4846 .TP
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4847 .B tile=xtiles:ytiles:output:start:delta
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4848 Tile a series of images into a single, bigger image.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4849 If you omit a parameter or use a value less than 0, then the default
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4850 value is used.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4851 You can also stop when you are satisfied (... \-vf tile=10:5 ...).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4852 It is probably a good idea to put the scale filter before the tile :-)
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4853 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4854 The parameters are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4855 .sp 1
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4856 .PD 0
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4857 .RSs
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4858 .IPs <xtiles>
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4859 number of tiles on the x axis (default: 5)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4860 .IPs <ytiles>
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4861 number of tiles on the y axis (default: 5)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4862 .IPs <output>
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4863 Render the tile when 'output' number of frames are reached, where 'output'
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4864 should be a number less than xtile * ytile.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4865 Missing tiles are left blank.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4866 You could, for example, write an 8 * 7 tile every 50 frames to have one
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4867 image every 2 seconds @ 25 fps.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4868 .IPs <start>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4869 outer border thickness in pixels (default: 2)
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4870 .IPs <delta>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4871 inner border thickness in pixels (default: 4)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4872 .RE
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4873 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4874 .
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4875 .TP
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4876 .B delogo[=x:y:w:h:t]
10813
f646e30ba119 spelling/wording fixes
diego
parents: 10812
diff changeset
4877 Suppresses a TV station logo by a simple interpolation of the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4878 surrounding pixels.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4879 Just set a rectangle covering the logo and watch it disappear (and
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4880 sometimes something even uglier appear \- your mileage may vary).
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4881 .PD 0
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4882 .RSs
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4883 .IPs x,y
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4884 top left corner of the logo
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4885 .IPs w,h
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4886 width and height of the cleared rectangle
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4887 .IPs t
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4888 Thickness of the fuzzy edge of the rectangle (added to w and h).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4889 When set to -1, a green rectangle is drawn on the screen to
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4890 simplify finding the right x,y,w,h parameters.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4891 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4892 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4893 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4894 .TP
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4895 .B zrmjpeg[=options]
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4896 Software YV12 to MJPEG encoder for use with the zr2 video
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4897 output device.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4898 .RSs
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4899 .IPs maxheight=h|maxwidth=w
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4900 These options set the maximum width and height the zr card
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4901 can handle (the MPlayer filter layer currently cannot query those).
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4902 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4903 Use these options to set maxwidth and maxheight automatically to the
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4904 values known for card/\:mode combo.
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4905 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL)
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4906 .IPs color|bw
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4907 Select color or black and white encoding.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4908 Black and white encoding is faster.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4909 Color is the default.
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4910 .IPs hdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4911 Horizontal decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4912 .IPs vdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4913 Vertical decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4914 .IPs quality=1-20
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4915 Set JPEG compression quality [BEST] 1 - 20 [VERY BAD].
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4916 .IPs fd|nofd
12028
91eb4f10a9ad spelling fixes
diego
parents: 12016
diff changeset
4917 By default, decimation is only performed if the Zoran hardware
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4918 can upscale the resulting MJPEG images to the original size.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4919 The option fd instructs the filter to always perform the requested
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4920 decimation (ugly).
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4921 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4922 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4923 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4924 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4925 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4926 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4927 .TP
11454
gabucino
parents: 11448
diff changeset
4928 .B \-audio-delay <0.0\-...>
gabucino
parents: 11448
diff changeset
4929 Sets the audio delay field in the header.
gabucino
parents: 11448
diff changeset
4930 Default is 0.0, negative values do not work.
gabucino
parents: 11448
diff changeset
4931 This does not delay the audio while encoding, but the player will see the
gabucino
parents: 11448
diff changeset
4932 default audio delay, sparing you the use of the \-delay option.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4933 .
11454
gabucino
parents: 11448
diff changeset
4934 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4935 .B \-audio-density <1\-50>
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4936 Number of audio chunks per second (default is 2 for 0.5s long audio chunks).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4937 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4938 .I NOTE:
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4939 CBR only, VBR ignores this as it puts each packet in a new chunk.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4940 .
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4941 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4942 .B \-audio-preload <0.0\-2.0>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4943 Sets up the audio buffering time interval (default: 0.5s).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4944 .
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4945 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4946 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4947 Stop encoding at the given time or byte position.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4948 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4949 .I NOTE:
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4950 Byte position will not be accurate, as it can only stop at
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4951 a frame boundary.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4952 .sp 1
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
4953 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4954 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4955 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4956 .IPs "\-endpos 56"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4957 Encode only 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4958 .IPs "\-endpos 01:10:00"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4959 Encode only 1 hour 10 minutes.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4960 .IPs "\-endpos 100mb"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4961 Encode only 100 MBytes.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4962 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4963 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4964 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4965 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4966 .B \-ffourcc <fourcc>
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4967 Can be used to override the video fourcc of the output file.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4968 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4969 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4970 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4971 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4972 .IPs "\-ffourcc div3"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4973 Will have the output file contain 'div3' as video fourcc.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4974 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4975 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4976 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4977 .TP
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4978 .B \-force-avi-aspect <0.2\-3.0>
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4979 Override the aspect stored in the AVI OpenDML vprp header.
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4980 This can be used to change the aspect ratio with \-ovc copy.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4981 .
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4982 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4983 .B \-info <option1:option2:...> (AVI only)
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4984 Specify the info header of the resulting AVI file.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4985 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4986 Available options are:
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4987 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4988 .IPs help\
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4989 Show this description.
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4990 .IPs name=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4991 title of the work
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4992 .IPs artist=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4993 artist or author of the work
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4994 .IPs genre=<value>
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4995 original work category
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4996 .IPs subject=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4997 contents of the work
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4998 .IPs copyright=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4999 copyright information
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5000 .IPs srcform=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
5001 original format of the digitized material
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5002 .IPs comment=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
5003 general comments about the work
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5004 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5005 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5006 .TP
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
5007 .B \-noautoexpand
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
5008 Do not automatically insert the expand filter into the MEncoder filter chain.
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
5009 Useful to control at which point of the filter chain subtitles are rendered
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
5010 when hardcoding subtitles onto a movie.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5011 .
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
5012 .TP
13270
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5013 .B \-noencodedups
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5014 Do not attempt to encode duplicate frames in duplicate; always output
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5015 zero-byte frames to indicate duplicates.
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5016 Zero-byte frames will be written anyway unless a filter or encoder
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5017 capable of doing duplicate encoding is loaded.
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5018 Currently the only such filter is harddup.
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5019 .
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
5020 .TP
12366
b6ff3941519b standard notation
diego
parents: 12363
diff changeset
5021 .B \-noodml (\-of avi only)
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5022 Do not write OpenDML index for AVI files >1GB.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5023 .
12363
5dac21977312 Allow user to disable writing of ODML index
ranma
parents: 12339
diff changeset
5024 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
5025 .B \-noskip
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5026 Do not skip frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5027 .
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
5028 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5029 .B \-o <filename>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5030 Outputs to the given filename, instead of the default 'test.avi'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5031 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5032 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5033 .B \-oac <codec name>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5034 Encode with the given audio codec (no default set).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5035 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5036 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5037 Use \-oac help to get a list of available audio codecs.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5038 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5039 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5040 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5041 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5042 .IPs "\-oac copy"
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5043 no encoding, just streamcopy
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5044 .IPs "\-oac pcm"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5045 Encode to uncompressed PCM.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5046 .IPs "\-oac mp3lame"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5047 Encode to MP3 (using LAME).
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5048 .IPs "\-oac lavc"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5049 Encode with a libavcodec codec.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5050 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5051 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5052 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5053 .TP
8685
a90839057e15 -of is beta code
jonas
parents: 8682
diff changeset
5054 .B \-of <format> (BETA CODE!)
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5055 Encode to the specified container format (default: AVI).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5056 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5057 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5058 Use \-of help to get a list of available container formats.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5059 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5060 .I EXAMPLE:
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5061 .PD 0
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5062 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5063 .IPs "\-of avi"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5064 Encode to AVI.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5065 .IPs "\-of mpeg"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5066 Encode to MPEG.
12016
b962aaad2940 rawvideo muxer patch by John Earl <jwe21@cam.ac.uk>
ranma
parents: 12013
diff changeset
5067 .IPs "\-of rawvideo"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5068 raw video stream (no muxing - one video stream only)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5069 .RE
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5070 .PD 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5071 .
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
5072 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5073 .B \-ofps <fps>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5074 Specify a frames per second (fps) value for the output file,
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5075 which can be different from that of the source material.
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5076 Must be set for variable fps (ASF, some MOV) and progressive
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5077 (29.97fps telecined MPEG) files.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5078 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5079 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5080 .B \-ovc <codec name>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5081 Encode with the given video codec (no default set).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5082 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5083 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5084 Use \-ovc help to get a list of available video codecs.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5085 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5086 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5087 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5088 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5089 .IPs "\-ovc copy"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5090 no encoding, just streamcopy
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5091 .IPs "\-ovc divx4"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5092 Encode to DivX4/\:DivX5.
11966
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
5093 .IPs "\-ovc raw"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5094 Encode to an arbitrary uncompressed format (use \-vf format to select).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5095 .IPs "\-ovc lavc"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5096 Encode with a libavcodec codec.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5097 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5098 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5099 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5100 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5101 .B \-passlogfile <filename>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5102 Dump first pass information to <filename> instead of the default divx2pass.log
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5103 in 2-pass encoding mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5104 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5105 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5106 .B \-skiplimit <value>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5107 Specify the maximum number of frames that may be skipped after
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5108 encoding one frame (\-noskiplimit for unlimited).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5109 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5110 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
5111 .B \-vobsubout <basename>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5112 Specify the basename for the output .idx and .sub files.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5113 This turns off subtitle rendering in the encoded movie and diverts it to
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
5114 VOBsub subtitle files.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5115 .
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
5116 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
5117 .B \-vobsuboutid <langid>
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
5118 Specify the language two letter code for the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
5119 This overrides what is read from the DVD or the .ifo file.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5120 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
5121 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
5122 .B \-vobsuboutindex <index>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5123 Specify the index of the subtitles in the output files (default: 0).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5124 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5125 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5126 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5127 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5128 You can specify codec specific encoding parameters using the following
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5129 syntax:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5130 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5131 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5132 .B \-<codec>opts <option1[=value],option2,...>
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
5133 .
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5134 .PP
13638
f453d6526a06 Added missing toolame to the list of codec specific encoding options.
diego
parents: 13636
diff changeset
5135 Where <codec> may be: lavc, xvidenc, divx4, lame, toolame, x264enc
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5136 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5137 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5138 .SS divx4 (\-divx4opts)
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
5139 DivX4 is obsolete and only supported for completeness.
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
5140 For details about DivX4 options, read the source, most options are not
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
5141 described here.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5142 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5143 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5144 .B help\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5145 get help
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5146 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5147 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5148 .B br=<value>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5149 Specify bitrate.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5150 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5151 .IPs 4\-16000
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5152 (in kbit)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5153 .IPs 16001\-24000000
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5154 (in bit)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5155 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5156 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5157 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5158 .B key=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5159 maximum keyframe interval (in frames)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5160 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5161 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5162 .B deinterlace
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5163 Enable deinterlacing (avoid it, DivX4 is buggy).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5164 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5165 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5166 .B q=<1\-5>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5167 quality (1\-fastest, 5\-best)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5168 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5169 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5170 .B min_quant=<1\-31>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5171 minimum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5172 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5173 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5174 .B max_quant=<1\-31>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5175 maximum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5176 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5177 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5178 .B rc_period=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5179 rate control period
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5180 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5181 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5182 .B rc_reaction_period=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5183 rate control reaction period
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5184 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5185 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5186 .B rc_reaction_ratio=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5187 rate control reaction ratio
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5188 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5189 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5190 .B crispness=<0\-100>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5191 Specify crispness/\:smoothness.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5192 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5193 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5194 .B pass=<1\-2>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5195 With this you can encode 2pass DivX4 files.
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5196 First encode with pass=1, then do another encode with the
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5197 same parameters and pass=2.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5198 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5199 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5200 .B vbrpass=<0\-2>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5201 Override the pass argument and use the XviD VBR library instead of DivX4 VBR.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5202 Available options are:
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5203 .RSs
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5204 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5205 one pass encoding (as in not putting pass on the command line)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5206 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5207 Analysis (first) pass of two pass encoding.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5208 The resulting AVI file can be directed to /dev/\:null.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5209 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5210 Final (second) pass of two pass encoding.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5211 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5212 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5213 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5214 .SS lame (\-lameopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5215 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5216 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5217 .B help\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5218 get help
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5219 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5220 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5221 .B vbr=<0\-4>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5222 variable bitrate method
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5223 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5224 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5225 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5226 cbr
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5227 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5228 mt
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5229 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5230 rh (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5231 .IPs 3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5232 abr
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5233 .IPs 4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5234 mtrh
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5235 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5236 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5237 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5238 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5239 .B abr\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5240 average bitrate
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5241 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5242 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5243 .B cbr\ \ \ \
13648
0dd7df7510a5 missing sentence dots
wight
parents: 13642
diff changeset
5244 constant bitrate
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5245 Also forces CBR mode encoding on subsequent ABR presets modes.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5246 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5247 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5248 .B br=<0\-1024>
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5249 bitrate in kbps (CBR and ABR only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5250 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5251 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5252 .B q=<0\-9>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5253 quality (0\-highest, 9\-lowest) (VBR only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5254 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5255 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5256 .B aq=<0\-9>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5257 algorithmic quality (0\-best/\:slowest, 9\-worst/\:fastest)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5258 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5259 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5260 .B ratio=<1\-100>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5261 compression ratio
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5262 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5263 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5264 .B vol=<0\-10>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5265 audio input gain
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5266 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5267 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5268 .B mode=<0\-3>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5269 (default: auto)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5270 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5271 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5272 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5273 stereo
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5274 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5275 joint-stereo
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5276 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5277 dualchannel
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5278 .IPs 3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5279 mono
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5280 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5281 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5282 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5283 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5284 .B padding=<0\-2>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5285 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5286 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5287 .IPs 0
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5288 none
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5289 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5290 all
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5291 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5292 adjust
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5293 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5294 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5295 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5296 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5297 .B fast\ \ \
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5298 Switch on faster encoding on subsequent VBR presets modes.
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5299 This results in slightly lower quality and higher bitrates.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5300 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5301 .TP
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5302 .B highpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5303 Set a highpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5304 Frequencies below the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
5305 A value of -1 will disable filtering, a value of 0
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5306 will let LAME choose values automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5307 .
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5308 .TP
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5309 .B lowpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5310 Set a lowpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5311 Frequencies above the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
5312 A value of -1 will disable filtering, a value of 0
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5313 will let LAME choose values automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5314 .
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5315 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5316 .B preset=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5317 preset values
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5318 .RSs
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5319 .IPs help\
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5320 Print additional options and information about presets settings.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5321 .IPs medium
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5322 VBR encoding, good quality, 150\-180 kbps bitrate range
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5323 .IPs standard
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5324 VBR encoding, high quality, 170\-210 kbps bitrate range
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5325 .IPs extreme
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5326 VBR encoding, very high quality, 200\-240 kbps bitrate range
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5327 .IPs insane
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5328 CBR encoding, highest preset quality, 320 kbps bitrate
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5329 .IPs <8\-320>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5330 ABR encoding at average given kbps bitrate
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5331 .RE
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5332 .sp 1
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5333 .RS
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5334 .I EXAMPLE:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5335 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5336 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5337 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5338 .IPs fast:preset=standard
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5339 suitable for most people and most music types and already quite high quality
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5340 .IPs cbr:preset=192
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5341 Encode with ABR presets at a 192 kbps forced constant bitrate.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5342 .IPs preset=172
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5343 Encode with ABR presets at a 172 kbps average bitrate.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5344 .IPs preset=extreme
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5345 for people with extremely good hearing and similar equipment
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5346 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5347 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5348 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5349 .
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5350 .SS toolame (\-toolameopts)
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5351 .
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5352 .TP
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5353 .B br=<0\-384> (CBR only)
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5354 bitrate in kbps
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5355 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5356 .B mode=<stereo | jstereo | mono | dual>
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5357 (default: mono for 1-channel audio, stereo otherwise)
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5358 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5359 .B psy=<0\-3>
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5360 psychoacoustic model (default: 2)
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5361 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5362 .B errprot=<0 | 1>
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5363 Include error protection.
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5364 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5365 .B debug=<0\-10>
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5366 debug level
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5367 .RE
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5368 .PD 1
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5369 .
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5370 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5371 .SS lavc (\-lavcopts)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5372 Many libavcodec (lavc for short) options are tersely documented.
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5373 Read the source for full details.
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5374 .PP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5375 .I EXAMPLE:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5376 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5377 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5378 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5379 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5380 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5381 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5382 .TP
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5383 .B acodec=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5384 audio codec (default: mp2)
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5385 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5386 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5387 .IPs mp2\ \
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5388 MPEG Layer 2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5389 .IPs mp3\ \
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5390 MPEG Layer 3
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5391 .IPs ac3\ \
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5392 AC3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5393 .IPs adpcm_ima_wav
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5394 IMA Adaptive PCM (4bits per sample, 4:1 compression)
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5395 .RE
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5396 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5397 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5398 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5399 .B abitrate=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5400 audio bitrate in kbps (default: 224)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5401 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5402 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5403 .B atag=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5404 Use the specified Windows audio format tag (e.g.\& atag=0x55).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5405 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5406 .TP
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
5407 .B bit_exact
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5408 Use only bit exact algorithms (except (I)DCT).
11938
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5409 Additionally bit_exact disables several optimizations and thus
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5410 should only be used for regression tests, which need binary
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5411 identical files even if the encoder version changes.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5412 This also suppresses the user_data header in MPEG-4 streams.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5413 Do not use this option unless you know exactly what you are doing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5414 .
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
5415 .TP
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5416 .B threads=<1\-8>
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5417 Maximum number of threads to use (default: 1).
13208
a4601e903824 The threads lavc option may negatively affect motion estimation.
diego
parents: 13205
diff changeset
5418 May have a slight negative effect on motion estimation.
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5419 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5420 .
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5421 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5422 .B vcodec=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5423 Employ the specified codec (default: mpeg4).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5424 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5425 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5426 .IPs mjpeg
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5427 Motion JPEG
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5428 .IPs ljpeg
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5429 Lossless JPEG
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5430 .IPs h263\
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5431 H.263
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5432 .IPs h263p
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5433 H.263+
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5434 .IPs mpeg4
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5435 MPEG-4 (DivX 4/5)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5436 .IPs msmpeg4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5437 DivX 3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5438 .IPs msmpeg4v2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5439 MS MPEG4v2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5440 .IPs wmv1\
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
5441 Windows Media Video, version 1 (AKA WMV7)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5442 .IPs wmv2\
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
5443 Windows Media Video, version 2 (AKA WMV8)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5444 .IPs rv10\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5445 an old RealVideo codec
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5446 .IPs mpeg1video
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5447 MPEG-1 video
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5448 .IPs mpeg2video
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5449 MPEG-2 video
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5450 .IPs huffyuv
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5451 HuffYUV
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5452 .IPs asv1\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5453 ASUS Video v1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5454 .IPs asv2\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5455 ASUS Video v2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5456 .IPs ffv1\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5457 FFmpeg's lossless video codec
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5458 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5459 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5460 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5461 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5462 .B vqmin=<1\-31>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5463 minimum quantizer (pass\ 1/\:2)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5464 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5465 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5466 Not recommended (much larger file, little quality difference and weird side
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5467 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5468 resulting in lower quality and some decoders will not be able to decode it).
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5469 .IPs 2
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5470 Recommended for normal mpeg4/\:mpeg1video encoding (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5471 .IPs 3
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5472 Recommended for h263(p)/\:msmpeg4.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5473 The reason for preferring 3 over 2 is that 2 could lead to overflows.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5474 (This will be fixed for h263(p) by changing the quantizer per MB in
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5475 the future, msmpeg4 cannot be fixed as it does not support that.)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5476 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5477 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5478 .TP
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5479 .B lmin=<0.01\-255.0>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5480 Minimum Lagrange multiplier for ratecontrol, you probably want it to be
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5481 equal to or lower than vqmin (default: 2.0).
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5482 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5483 .
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5484 .TP
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5485 .B lmax=<0.01\-255.0>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5486 maximum Lagrange multiplier for ratecontrol (default: 31.0)
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5487 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5488 .
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5489 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5490 .B vqscale=<1\-31>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5491 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5492 A lower value means better quality but larger files (default: 0 (disabled)).
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5493 1 is not recommended (see vqmin for details).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5494 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5495 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5496 .B vqmax=<1\-31>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5497 Maximum quantizer (pass\ 1/\:2), 10\-31 should be a sane range (default: 31).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5498 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5499 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5500 .B mbqmin=<1\-31>
13930
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5501 obsolete, use vqmin
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5502 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5503 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5504 .B mbqmax=<1\-31>
13930
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5505 obsolete, use vqmax
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5506 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5507 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5508 .B vqdiff=<1\-31>
13930
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5509 maximum quantizer difference between consecutive I- or P-frames
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5510 (pass\ 1/\:2) (default: 3)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5511 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5512 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5513 .B vmax_b_frames=<0\-4>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5514 maximum number of B-frames between non-B-frames:
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5515 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5516 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5517 .IPs 0
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5518 no B-frames (default)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5519 .IPs 0\-2
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5520 sane range for MPEG-4
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5521 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5522 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5523 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5524 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5525 .B vme=<0\-5>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5526 motion estimation method.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5527 Available methods are:
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5528 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5529 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5530 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5531 none (very low quality)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5532 .IPs 1
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5533 full (slow, currently unmaintained and disabled)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5534 .IPs 2
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5535 log (low quality, currently unmaintained and disabled)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5536 .IPs 3
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5537 phods (low quality, currently unmaintained and disabled)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5538 .IPs 4
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5539 EPZS: size=1 diamond, size can be adjusted with the *dia options
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5540 (default)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5541 .IPs 5
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5542 X1 (experimental, currently aliased to EPZS)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5543 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5544 .PD 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5545 .sp 1
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5546 .RS
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5547 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5548 .I NOTE:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5549 0\-3 currently ignores the amount of bits spent,
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5550 so quality may be low.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5551 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5552 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5553 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5554 .B me_range=<0\-9999>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5555 motion estimation search range (default: 0 (unlimited))
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5556 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5557 .TP
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5558 .B mbd=<0\-2>
10503
diego
parents: 10498
diff changeset
5559 Macroblock decision algorithm (high quality mode), encode each macro
diego
parents: 10498
diff changeset
5560 block in all modes and choose the best.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5561 This is slow but results in better quality and file size.
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5562 .PD 0
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5563 .RSs
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5564 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5565 Use mbcmp (default).
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5566 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5567 Select the MB mode which needs the fewest bits (=vhq).
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5568 .IPs 2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5569 Select the MB mode which has the best rate distortion.
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5570 .RE
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5571 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5572 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5573 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5574 .B vhq\ \ \ \
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5575 Same as mbd=1, kept for compatibility reasons.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5576 .
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5577 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5578 .B v4mv\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5579 Allow 4 motion vectors per macroblock (slightly better quality).
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5580 Works better if used with mbd>0.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5581 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5582 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5583 .B obmc\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5584 overlapped block motion compensation (H.263+)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5585 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5586 .TP
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5587 .B loop\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5588 loop filter (H.263+)
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5589 note, this is broken
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5590 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5591 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5592 .B inter_threshold <-1000\-1000>
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5593 Does absolutely nothing at the moment.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5594 .
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5595 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5596 .B keyint=<0\-300>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5597 maximum interval between keyframes in frames (default: 250 or one
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5598 keyframe every ten seconds in a 25fps movie).
13930
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5599 Keyframes are needed for seeking as seeking is only possible to a keyframe, but
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5600 keyframes need more space than other frames, so larger numbers here mean
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5601 slightly smaller files but less precise seeking.
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5602 0 is equivalent to 1, which makes every frame a keyframe.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5603 Values >300 are not recommended as the quality might be bad depending upon
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5604 decoder, encoder and luck.
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5605 For a strict MPEG-1/2/4 compliance this would have to be <=132.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5606 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5607 .TP
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5608 .B sc_threshold=<-1000000\-1000000>
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5609 Threshold for scene change detection.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5610 Libavcodec inserts a keyframe when it detects a scene change.
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5611 You can specify the sensitivity of the detection with this option.
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5612 -1000000 means there is a scene change detected at every frame, 1000000 means
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5613 no scene changes are detected (default 0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5614 .
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5615 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5616 .B vb_strategy=<0\-1>
13930
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5617 strategy to choose between I/\:P/\:B-frames (pass\ 1):
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5618 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5619 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5620 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5621 Always use the maximum number of B-frames (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5622 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5623 Avoid B-frames in high motion scenes.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5624 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5625 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5626 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5627 .TP
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5628 .B vpass=<1\-3>
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5629 Activates internal two (or three) pass mode, only specify if you wish to
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5630 use two (or three) pass encoding.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5631 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5632 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5633 .IPs 1
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5634 first pass (also see turbo)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5635 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5636 second pass
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5637 .IPs 3
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5638 Nth pass (second and third passes of three pass encoding)
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5639 .RE
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5640 .RS
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5641 Here is how it works, and how to use it:
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5642 .br
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5643 The first pass (vpass=1) writes the stats file.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5644 You might want to deactivate some CPU-hungry options, like "turbo"
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5645 mode does.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5646 .br
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5647 In two pass mode, the second pass (vpass=2) reads the stats file and
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5648 bases ratecontrol decisions on it.
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5649 .br
13930
389b6b59a5a5 update description of lavc's keyint, vb_strategy, and mbqmin.
lorenm
parents: 13913
diff changeset
5650 In three pass mode, the second pass (vpass=3, that is not a typo)
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5651 does both: It first reads the stats, then overwrites them.
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5652 You might want to backup divx2pass.log before doing this if there is
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5653 any possibility that you will have to cancel MEncoder.
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5654 You can use all encoding options, except very CPU-hungry options like "qns".
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5655 .br
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5656 The third pass (vpass=3) is the same as the second pass, except that it has
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5657 the second pass's stats to work from.
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5658 You can use all encoding options, including CPU-hungry ones.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5659 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5660 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5661 .sp 1
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5662 .RS
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5663 huffyuv:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5664 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5665 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5666 .RSs
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
5667 .IPs "pass 1"
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
5668 Saves statistics.
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
5669 .IPs "pass 2"
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5670 Encodes with an optimal Huffman table based upon statistics
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5671 from the first pass.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5672 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5673 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5674 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5675 .TP
13386
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5676 .B turbo (2-pass only)
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5677 Dramatically speeds up pass 1 using faster algorithms and disabling
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5678 CPU-intensive options.
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5679 This will probably reduce global PSNR a little bit (around 0.01dB) and
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5680 change individual frame type and PSNR little bit more (up to 0.03dB).
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5681 .
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5682 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5683 .B aspect=<x/\:y>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5684 Store movie aspect internally, just like with MPEG files.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5685 Much nicer than rescaling, because quality is not decreased.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5686 Only MPlayer will play these files correctly, other players will display
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5687 them with wrong aspect.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5688 The aspect parameter can be given as a ratio or a floating point number.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5689 .sp 1
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5690 .RS
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5691 .I EXAMPLE:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5692 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5693 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5694 .PD 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5695 .IPs "aspect=16/\:9 or aspect=1.78"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5696 .PD 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5697 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5698 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5699 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5700 .B autoaspect
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5701 Same as the aspect option, but automatically computes aspect, taking
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5702 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5703 filter chain.
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5704 Does not incur a performance penalty, so you can safely leave it
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5705 always on.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5706 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5707 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5708 .B vbitrate=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5709 Specify bitrate (pass\ 1/\:2) (default: 800).
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5710 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5711 .I WARNING:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5712 1kBit = 1000 Bits
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5713 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5714 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5715 .IPs 4\-16000
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5716 (in kbit)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5717 .IPs 16001\-24000000
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5718 (in bit)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5719 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5720 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5721 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5722 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5723 .B vratetol=<value>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5724 approximated filesize tolerance in kBit.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5725 1000\-100000 is a sane range.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5726 (warning: 1kBit = 1000 Bits)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5727 (default: 8000)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5728 .br
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5729 .I NOTE:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5730 vratetol should not be too large during the second pass or there might
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5731 be problems if vrc_(min|max)rate is used.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5732 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5733 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5734 .B vrc_maxrate=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5735 maximum bitrate in kbit/\:sec (pass\ 1/\:2)
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
5736 (default: 0, unlimited)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5737 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5738 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5739 .B vrc_minrate=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5740 minimum bitrate in kbit/\:sec (pass\ 1/\:2)
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
5741 (default: 0, unlimited)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5742 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5743 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5744 .B vrc_buf_size=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5745 buffer size in kbit (pass\ 1/\:2).
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5746 For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD,
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5747 917 for SVCD and 1835 for DVD.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5748 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5749 .TP
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5750 .B vrc_buf_aggressivity
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5751 currently useless
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5752 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5753 .TP
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5754 .B vrc_strategy
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5755 Dummy, reserved for future use.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5756 .
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5757 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5758 .B vb_qfactor=<-31.0\-31.0>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5759 quantizer factor between B- and non-B-frames (pass\ 1/\:2) (default: 1.25)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5760 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5761 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5762 .B vi_qfactor=<-31.0\-31.0>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5763 quantizer factor between I- and non-I-frames (pass\ 1/\:2) (default: 0.8)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5764 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5765 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5766 .B vb_qoffset=<-31.0\-31.0>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5767 quantizer offset between B- and non-B-frames (pass\ 1/\:2) (default: 1.25)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5768 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5769 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5770 .B vi_qoffset=<-31.0\-31.0>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5771 (pass\ 1/\:2) (default: 0.0)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5772 .br
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5773 if v{b|i}_qfactor > 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5774 .br
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5775 I/\:B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5776 .br
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5777 else
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5778 .br
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5779 do normal ratecontrol (do not lock to next P-frame quantizer) and
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5780 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5781 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5782 .I HINT:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5783 To do constant quantizer encoding with different quantizers for
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5784 I/\:P- and B-frames you can use:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5785 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5786 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5787 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5788 .B vqblur=<0.0\-1.0> (pass 1)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5789 Quantizer blur (default: 0.5), larger values will average the
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5790 quantizer more over time (slower change).
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5791 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5792 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5793 .IPs 0.0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5794 Quantizer blur disabled.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5795 .IPs 1.0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5796 Average the quantizer over all previous frames.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5797 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5798 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5799 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5800 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5801 .B vqblur=<0.0\-99.0> (pass 2)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5802 Quantizer gaussian blur (default: 0.5), larger values will average
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5803 the quantizer more over time (slower change).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5804 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5805 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5806 .B vqcomp=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5807 Quantizer compression, depends upon vrc_eq (pass\ 1/\:2) (default: 0.5).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5808 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5809 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5810 .B vrc_eq=<equation>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5811 main ratecontrol equation (pass\ 1/\:2)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5812 .RE
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5813 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5814 .IPs 1\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5815 constant bitrate
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5816 .IPs tex\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5817 constant quality
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5818 .IPs 1+(tex/\:avgTex-1)*qComp
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5819 approximately the equation of the old ratecontrol code
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5820 .IPs tex^qComp
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5821 with qcomp 0.5 or something like that (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5822 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5823 .PP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5824 .RS
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5825 infix operators:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5826 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5827 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5828 .IPs +,-,*,/,^
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5829 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5830 .PP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5831 .RS
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5832 variables:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5833 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5834 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5835 .IPs tex\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5836 texture complexity
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5837 .IPs iTex,pTex
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5838 intra, non-intra texture complexity
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5839 .IPs avgTex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5840 average texture complexity
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5841 .IPs avgIITex
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5842 average intra texture complexity in I-frames
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5843 .IPs avgPITex
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5844 average intra texture complexity in P-frames
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5845 .IPs avgPPTex
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5846 average non-intra texture complexity in P-frames
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5847 .IPs avgBPTex
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5848 average non-intra texture complexity in B-frames
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5849 .IPs mv\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5850 Bits used for motion vectors
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5851 .IPs fCode
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5852 maximum length of motion vector in log2 scale
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5853 .IPs iCount
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5854 number of intra macroblocks / number of macroblocks
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5855 .IPs var\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5856 spatial complexity
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5857 .IPs mcVar
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5858 temporal complexity
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5859 .IPs qComp
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5860 qcomp from the command line
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5861 .IPs "isI, isP, isB"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5862 Is 1 if picture type is I/\:P/\:B else 0.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5863 .IPs Pi,E\
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5864 See your favorite math book.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5865 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5866 .PP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5867 .RS
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5868 functions:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5869 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5870 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5871 .IPs max(a,b),min(a,b)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5872 maximum / minimum
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5873 .IPs gt(a,b)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5874 is 1 if a>b, 0 otherwise
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5875 .IPs lt(a,b)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5876 is 1 if a<b, 0 otherwise
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5877 .IPs eq(a,b)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5878 is 1 if a==b, 0 otherwise
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5879 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5880 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5881 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5882 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5883 .B vrc_override=<options>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5884 User specified quality for specific parts (ending, credits, ...) (pass\ 1/\:2).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5885 The options are <start-frame>, <end-frame>, <quality>[/\:<start-frame>,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5886 <end-frame>, <quality>[/\:...]]:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5887 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5888 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5889 .IPs "quality (2\-31)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5890 quantizer
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5891 .IPs "quality (-500\-0)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5892 quality correction in %
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5893 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5894 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5895 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5896 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5897 .B vrc_init_cplx=<0\-1000>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5898 initial complexity (pass\ 1)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5899 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5900 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5901 .B vqsquish=<0,1>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5902 Specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5903 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5904 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5905 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5906 Use clipping.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5907 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5908 Use a nice differentiable function (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5909 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5910 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5911 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5912 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5913 .B vlelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5914 Sets single coefficient elimination threshold for luminance.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5915 Negative values will also consider the DC coefficient (should be at least -4
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5916 or lower for encoding at quant=1):
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5917 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5918 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5919 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5920 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5921 .IPs -4
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5922 JVT recommendation
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5923 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5924 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5925 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5926 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5927 .B vcelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5928 Sets single coefficient elimination threshold for chrominance.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5929 Negative values will also consider the DC coefficient (should be at least -4
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5930 or lower for encoding at quant=1):
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5931 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5932 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5933 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5934 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5935 .IPs 7
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5936 JVT recommendation
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5937 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5938 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5939 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5940 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5941 .B vstrict=<-1,0,1>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5942 strict standard compliance
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5943 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5944 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5945 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5946 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5947 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5948 Only recommended if you want to feed the output into the
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
5949 MPEG-4 reference decoder.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5950 .IPs -1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5951 Allows non-standard YV12 HuffYUV encoding (20% smaller files, but cannot be
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5952 played by the official HuffYUV codec).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5953 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5954 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5955 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5956 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5957 .B vdpart\
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5958 Data partitioning.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5959 Adds 2 Bytes per video packet, improves error-resistance when transferring over
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5960 unreliable channels (e.g.\& streaming over the internet).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5961 Each video packet will be encoded in 3 separate partitions:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5962 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5963 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5964 .IPs "1. MVs"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5965 movement
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5966 .IPs "2. DC coefficients"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5967 low res picture
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5968 .IPs "3. AC coefficients"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5969 details
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5970 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5971 .PD 1
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5972 .RS
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5973 MV & DC are most important, loosing them looks far worse than loosing
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5974 the AC and the 1. & 2. partition.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5975 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5976 will hit the AC partition much more often than the MV & DC partitions.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5977 Thus, the picture will look better with partitioning than without,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5978 as without partitioning an error will trash AC/\:DC/\:MV equally.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5979 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5980 .
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5981 .TP
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5982 .B vpsize=<0\-10000> (also see vdpart)
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5983 Video packet size, improves error-resistance.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5984 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5985 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5986 .IPs 0\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5987 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5988 .IPs 100-1000
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5989 good choice
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5990 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5991 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5992 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5993 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5994 .B ss\ \ \ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5995 slice structured mode for H.263+
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5996 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5997 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5998 .B gray\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5999 grayscale only encoding (faster)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6000 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6001 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6002 .B vfdct=<0\-10>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6003 DCT algorithm
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6004 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6005 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6006 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6007 Automatically select a good one (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6008 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6009 fast integer
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6010 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6011 accurate integer
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6012 .IPs 3
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6013 MMX
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6014 .IPs 4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6015 mlib
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
6016 .IPs 5
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6017 AltiVec
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
6018 .IPs 6
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
6019 floating point AAN
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6020 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6021 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6022 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6023 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6024 .B idct=<0\-99>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6025 IDCT algorithm
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6026 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6027 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6028 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6029 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6030 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6031 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6032 Automatically select a good one (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6033 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6034 JPEG reference integer
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6035 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6036 simple
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6037 .IPs 3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6038 simplemmx
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6039 .IPs 4
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6040 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6041 .IPs 5
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6042 ps2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6043 .IPs 6
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6044 mlib
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6045 .IPs 7
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6046 arm
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
6047 .IPs 8
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6048 AltiVec
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
6049 .IPs 9
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
6050 sh4
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6051 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6052 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6053 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6054 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6055 .B lumi_mask=<0.0\-1.0>
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6056 Luminance masking is a 'psychosensory' setting that is supposed to
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6057 make use of the fact that the human eye tends to notice fewer details
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6058 in very bright parts of the picture.
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6059 Luminance masking compresses bright areas stronger than medium ones,
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6060 so it will save bits that can be spent again on other frames, raising
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6061 overall subjective quality, while possibly reducing PSNR.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6062 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6063 .I WARNING:
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
6064 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6065 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6066 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6067 Large values might look good on some monitors but may look horrible
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6068 on other monitors.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6069 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6070 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6071 .IPs 0.0\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6072 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6073 .IPs 0.0\-0.3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6074 sane range
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6075 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6076 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6077 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6078 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6079 .B dark_mask=<0.0\-1.0>
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6080 Darkness masking is a 'psychosensory' setting that is supposed to
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6081 make use of the fact that the human eye tends to notice fewer details
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
6082 in very dark parts of the picture.
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6083 Darkness masking compresses dark areas stronger than medium ones,
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6084 so it will save bits that can be spent again on other frames, raising
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
6085 overall subjective quality, while possibly reducing PSNR.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6086 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6087 .I WARNING:
13058
29d8052f48f7 consistency fix, same sentence should be changed to same
wight
parents: 13053
diff changeset
6088 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6089 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6090 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6091 Large values might look good on some monitors but may look horrible
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6092 on other monitors / TV / TFT.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6093 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6094 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6095 .IPs 0.0\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6096 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6097 .IPs 0.0\-0.3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6098 sane range
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6099 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6100 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6101 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6102 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6103 .B tcplx_mask=<0.0\-1.0>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6104 Temporal complexity masking (default: 0.0 (disabled)).
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6105 Imagine a scene with a bird flying across the whole scene; tcplx_mask
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
6106 will raise the quantizers of the bird's macroblocks (thus decreasing their
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6107 quality), as the human eye usually does not have time to see all the bird's
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6108 details.
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6109 Be warned that if the masked object stops (e.g.\& the bird lands) it is
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
6110 likely to look horrible for a short period of time, until the encoder
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6111 figures out that the object is not moving and needs refined blocks.
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6112 The saved bits will be spent on other parts of the video, which may increase
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6113 subjective quality, provided that tcplx_mask is carefully chosen.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6114 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6115 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6116 .B scplx_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6117 Spatial complexity masking.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6118 Larger values help against blockiness, if no deblocking filter is used for
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6119 decoding, which is maybe not a good idea.
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6120 .br
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6121 Imagine a scene with grass (which usually has great spatial complexity),
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6122 a blue sky and a house; scplx_mask will raise the quantizers of the grass'
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6123 macroblocks, thus decreasing its quality, in order to spend more bits on
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6124 the sky and the house.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6125 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6126 .I HINT:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6127 Crop any black borders completely as they will reduce the quality
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6128 of the macroblocks (also applies without scplx_mask).
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6129 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6130 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6131 .IPs 0.0\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6132 disabled (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6133 .IPs 0.0\-0.5
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6134 sane range
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6135 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6136 .PD 1
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6137 .sp 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6138 .RS
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6139 .I NOTE:
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6140 This setting does not have the same effect as using a custom matrix that
13492
51c46db54bd2 Sws default setting correction, and random wordings
gpoirier
parents: 13487
diff changeset
6141 would compress high frequencies harder, as scplx_mask will reduce the
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6142 quality of P blocks even if only DC is changing.
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6143 The result of scplx_mask will probably not look as good.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6144 .RE
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6145 .
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6146 .TP
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6147 .B p_mask=<0.0\-1.0> (also see vi_qfactor)
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6148 Reduces the quality of inter blocks.
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6149 This is equivalent to increasing the quality of intra blocks, because the
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6150 same average bitrate will be distributed by the rate controller to the
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6151 whole video sequence (default: 0.0 (disabled)).
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6152 p_mask=1.0 doubles the bits allocated to each intra block.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6153 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6154 .TP
11430
nicolas
parents: 11424
diff changeset
6155 .B naq\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6156 Normalize adaptive quantization (experimental).
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6157 When using adaptive quantization (*_mask), the average per-MB quantizer may no
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6158 longer match the requested frame-level quantizer.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6159 Naq will attempt to adjust the per-MB quantizers to maintain the proper
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6160 average.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6161 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6162 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6163 .B ildct\ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6164 Use interlaced DCT.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6165 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6166 .TP
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6167 .B ilme\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
6168 Use interlaced motion estimation (mutually exclusive with qpel).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6169 .
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6170 .TP
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6171 .B alt\ \ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6172 Use alternative scantable.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6173 .
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6174 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6175 .B top=<-1\-1>\ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6176 .PD 0
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6177 .RSs
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6178 .IPs -1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6179 automatic
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6180 .IPs 0
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6181 bottom field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6182 .IPs 1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6183 top field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6184 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6185 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6186 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6187 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6188 .B format=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6189 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6190 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6191 .IPs YV12\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6192 default
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6193 .IPs 444P\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6194 for ffv1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6195 .IPs 422P\
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6196 for HuffYUV, lossless JPEG and ffv1
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6197 .IPs 411P,YVU9
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6198 for lossless JPEG and ffv1
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6199 .IPs BGR32
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6200 for lossless JPEG and ffv1
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6201 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6202 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6203 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6204 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6205 .B pred\ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6206 (for HuffYUV)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6207 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6208 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6209 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6210 left prediction
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6211 .IPs 1
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6212 plane/\:gradient prediction
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6213 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6214 median prediction
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6215 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6216 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6217 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6218 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6219 .B pred\ \ \
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6220 (for lossless JPEG)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6221 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6222 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6223 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6224 left prediction
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6225 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6226 top prediction
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6227 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6228 topleft prediction
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6229 .IPs 3
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6230 plane/\:gradient prediction
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6231 .IPs 6
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6232 mean prediction
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6233 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6234 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6235 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6236 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6237 .B coder\ \
11059
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6238 (for ffv1)
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6239 .PD 0
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6240 .RSs
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6241 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6242 vlc coding (Golomb-Rice)
11059
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6243 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6244 arithmetic coding (CABAC)
11059
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6245 .RE
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6246 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6247 .
11059
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6248 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6249 .B context
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6250 (for ffv1)
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6251 .PD 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6252 .RSs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6253 .IPs 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6254 small context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6255 .IPs 1
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6256 large context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6257 .RE
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6258 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6259 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6260 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6261 .B qpel\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
6262 Use quarter pel motion compensation (mutually exclusive with ilme).
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6263 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6264 .I HINT:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6265 This seems only useful for high bitrate encodings.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6266 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6267 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6268 .B mbcmp=<0\-2000>
13648
0dd7df7510a5 missing sentence dots
wight
parents: 13642
diff changeset
6269 Sets the comparison function for the macroblock decision, only used if mbd=0.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6270 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6271 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6272 .IPs "0 (SAD)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6273 sum of absolute differences, fast (default)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6274 .IPs "1 (SSE)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6275 sum of squared errors
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6276 .IPs "2 (SATD)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6277 sum of absolute Hadamard transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6278 .IPs "3 (DCT)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6279 sum of absolute DCT transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6280 .IPs "4 (PSNR)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6281 sum of squared quantization errors (avoid, low quality)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6282 .IPs "5 (BIT)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6283 number of bits needed for the block
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6284 .IPs "6 (RD)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6285 rate distortion optimal, slow
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6286 .IPs "7 (ZERO)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6287 0
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
6288 .IPs "8 (VSAD)"
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6289 sum of absolute vertical differences
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
6290 .IPs "9 (VSSE)"
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
6291 sum of squared vertical differences
12593
michael
parents: 12581
diff changeset
6292 .IPs "10 (NSSE)"
michael
parents: 12581
diff changeset
6293 noise preserving sum of squared differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6294 .IPs +256\
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6295 Also use chroma, currently does not work (correctly) with B-frames.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6296 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6297 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6298 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6299 .TP
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6300 .B ildctcmp=<0\-2000>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6301 Sets the comparison function for interlaced DCT decision
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6302 (see mbcmp for available comparison functions).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6303 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6304 .TP
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6305 .B precmp=<0\-2000>
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6306 Sets the comparison function for motion estimation pre pass
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6307 (see mbcmp for available comparison functions) (default: 0).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6308 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6309 .TP
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6310 .B cmp=<0\-2000>
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6311 Sets the comparison function for full pel motion estimation
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6312 (see mbcmp for available comparison functions) (default: 0).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6313 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6314 .TP
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6315 .B subcmp=<0\-2000>
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6316 Sets the comparison function for sub pel motion estimation
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6317 (see mbcmp for available comparison functions) (default: 0).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6318 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6319 .TP
12607
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
6320 .B nssew=<0\-100>
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6321 This setting controls NSSE weight, where larger weights will result in
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6322 more noise.
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6323 0 NSSE is identical to SSE
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6324 You may find this useful if you prefer to keep some noise in your encoded
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6325 video rather than filtering it away before encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6326 .
12593
michael
parents: 12581
diff changeset
6327 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6328 .B predia=<-99\-6>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6329 diamond type and size for motion estimation pre-pass
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6330 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6331 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6332 .B dia=<-99\-6>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6333 Diamond type & size for motion estimation.
13417
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6334 Motion search is an iterative process.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6335 Using a small diamond does not limit the search to finding only small
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6336 motion vectors.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6337 It is just somewhat more likely to stop before finding the very best motion
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6338 vector, especially when noise is involved.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6339 Bigger diamonds allow a wider search for the best motion vector, thus are
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6340 slower but result in better quality.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6341 .br
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6342 Big normal diamonds are better quality than shape-adaptive diamonds.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6343 .br
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6344 Shape-adaptive diamonds are a good tradeoff between speed and quality.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6345 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6346 .I NOTE:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6347 The sizes of the normal diamonds and shape adaptive ones do not have
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6348 the same meaning.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6349 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6350 .IPs -3
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6351 shape adaptive (fast) diamond with size 3
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6352 .IPs -2
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6353 shape adaptive (fast) diamond with size 2
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6354 .IPs -1
13417
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6355 slightly special: Can be slower and/or better than dia=-2.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6356 .IPs 1
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6357 normal size=1 diamond (default) =EPZS type diamond
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6358 .nf
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6359 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6360 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6361 000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6362 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6363 .fi
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6364 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6365 normal size=2 diamond
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6366 .nf
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6367 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6368 0
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6369 000
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6370 00000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6371 000
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6372 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6373 .fi
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6374 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6375 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6376 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6377 .B trell\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6378 Trellis searched quantization.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6379 This will find the optimal encoding for each 8x8 block.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6380 Trellis searched quantization is quite simply an optimal quantization in
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6381 the PSNR versus bitrate sense (Assuming that there would be no rounding
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6382 errors introduced by the IDCT, which is obviously not the case.).
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6383 It simply finds a block for the minimum of error and lambda*bits.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6384 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6385 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6386 .IPs lambda
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6387 quantization parameter (QP) dependent constant
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
6388 .IPs bits\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6389 amount of bits needed to encode the block
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6390 .IPs error
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6391 sum of squared errors of the quantization
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6392 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6393 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6394 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6395 .TP
10963
michael
parents: 10917
diff changeset
6396 .B cbp\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6397 Rate distorted optimal coded block pattern.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6398 Will select the coded block pattern which minimizes distortion + lambda*rate.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6399 This can only be used together with trellis quantization.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6400 .
10963
michael
parents: 10917
diff changeset
6401 .TP
10974
michael
parents: 10969
diff changeset
6402 .B mv0\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6403 Try to encode each MB with MV=<0,0> and choose the better one.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6404 This has no effect if mbd=0.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6405 .
10974
michael
parents: 10969
diff changeset
6406 .TP
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6407 .B qprd (mbd=2 only)
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
6408 rate distorted optimal quantization parameter (QP) for the given
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6409 lambda of each macroblock
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6410 .
11446
michael
parents: 11443
diff changeset
6411 .TP
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6412 .B last_pred=<0\-99>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6413 amount of motion predictors from the previous frame
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6414 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6415 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6416 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6417 (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6418 .IPs a
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6419 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6420 previous frame.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6421 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6422 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6423 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6424 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6425 .B preme=<0\-2>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6426 motion estimation pre-pass
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6427 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6428 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6429 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6430 disabled
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6431 .IPs 1
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6432 only after I-frames (default)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6433 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6434 always
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6435 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6436 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6437 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6438 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6439 .B subq=<1\-8>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6440 subpel refinement quality (for qpel) (default: 8 (high quality))
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6441 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6442 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6443 This has a significant effect on speed.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6444 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6445 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6446 .B psnr\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6447 print the PSNR (peak signal to noise ratio) for the whole video after encoding
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6448 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6449 Returned values are in dB (decibel), the higher the better.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6450 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6451 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6452 .B mpeg_quant
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6453 Use MPEG quantizers instead of H.263.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6454 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6455 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6456 .B aic\ \ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6457 ac prediction (advanced intra prediction for H.263+)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6458 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6459 .I NOTE:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6460 vqmin should be 8 or larger for H.263+ AIC.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6461 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6462 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6463 .B aiv\ \ \ \
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6464 alternatice inter vlc for H.263+
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6465 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6466 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6467 .B umv\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6468 unlimited MVs (H.263+ only)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6469 Allows encoding of abritarily long MVs.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6470 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6471 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6472 .B ibias=<-256\-256>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6473 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96,
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6474 H.263 style quantizer default: 0)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6475 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6476 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6477 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6478 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6479 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6480 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6481 .B pbias=<-256\-256>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6482 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0,
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6483 H.263 style quantizer default: -64)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6484 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6485 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6486 The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6487 the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6488 .br
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6489 .I HINT:
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6490 A more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6491 .
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6492 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6493 .B nr=<0\-100000>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6494 Noise reduction, 0 means disabled.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6495 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6496 .TP
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6497 .B qns=<0\-3>
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6498 Quantizer noise shaping.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6499 Rather than choosing quantization to most closely match the source video
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6500 in the PSNR sense, it chooses quantization such that noise (usually ringing)
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6501 will be masked by similar-frequency content in the image.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6502 Larger values are slower but may not result in better quality.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6503 This can and should be used together with trellis quantization, in which case
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6504 the trellis quantization (optimal for constant weight) will be used as
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6505 startpoint for the iterative search.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6506 .PD 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6507 .RSs
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6508 .IPs 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6509 disabled (default)
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6510 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6511 Only lower the absolute value of coefficients.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6512 .IPs 2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6513 Only change coefficients before the last non-zero coefficient + 1.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6514 .IPs 3
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6515 Try all.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6516 .RE
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6517 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6518 .
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6519 .TP
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6520 .B inter_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6521 Use custom inter matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6522 It needs a comma separated string of 64 integers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6523 .
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6524 .TP
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6525 .B intra_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6526 Use custom intra matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6527 It needs a comma separated string of 64 integers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6528 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6529 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6530 .B vqmod_amp
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6531 experimental quantizer modulation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6532 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6533 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6534 .B vqmod_freq
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6535 experimental quantizer modulation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6536 .
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6537 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6538 .B dc\ \ \ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6539 intra DC precision in bits (default: 8).
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6540 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6541 .
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6542 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6543 .B cgop\ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6544 Close all GOPs.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6545 Currently it does not work.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6546 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6547 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6548 .SS nuv (\-nuvopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6549 .
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6550 Nuppel video is based on RTJPEG and LZO.
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6551 By default frames are first encoded with RTJPEG and then compressed with LZO,
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6552 but it is possible to disable either or both of the two passes.
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6553 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG,
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6554 or the default LZO compressed RTJPEG.
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6555 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6556 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6557 The nuvrec documentation contains some advice and examples about the
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6558 settings to use for the most common TV encodings.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6559 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6560 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6561 .B c=<0\-20>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6562 chrominance threshold (default: 1)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6563 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6564 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6565 .B l=<0\-20>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6566 luminance threshold (default: 1)
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6567 .
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6568 .TP
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6569 .B lzo\ \ \ \
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6570 Enable LZO compression (default).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6571 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6572 .TP
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6573 .B nolzo\ \
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6574 Disable LZO compression.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6575 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6576 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6577 .B q=<3\-255>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6578 quality level (default: 255)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6579 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6580 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
6581 .B raw \ \ \
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6582 Disable RTJPEG encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6583 .
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
6584 .TP
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
6585 .B rtjpeg\
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6586 Enable RTJPEG encoding (default).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6587 .
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
6588 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6589 .SS xvidenc (\-xvidencopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6590 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6591 There are three modes available: constant bitrate (CBR), fixed quantizer and
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6592 2pass.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6593 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6594 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6595 .B pass=<1|2>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6596 Specify the pass in 2pass mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6597 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6598 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6599 .B bitrate=<value>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6600 Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6601 if >16000.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6602 If <value> is negative, XviD will use its absolute value as the target size
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6603 (in kbytes) of the video and compute the associated bitrate automagically.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6604 (CBR or 2pass mode, default: 687 kbits/\:s)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6605 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6606 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6607 .B fixed_quant=<1\-31>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6608 Switch to fixed quantizer mode and specify the quantizer to be used.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6609 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6610 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6611 .B me_quality=<0\-6>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6612 This option controls the motion estimation subsystem.
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6613 The higher the value, the more precise the estimation should be (default: 6).
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6614 The more precise the motion estimation is, the more bits can be saved.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6615 Precision is gained at the expense of CPU time so decrease this setting if
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6616 you need realtime encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6617 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6618 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6619 .B (no)interlacing
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6620 Encode the fields of interlaced video material.
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6621 Turn this option on for interlaced content.
13257
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6622 .br
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6623 .I NOTE:
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6624 Should you rescale the video, you would need an interlace-aware resizer,
13257
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6625 which you can activate with -vf scale=<width>:<height>:1.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6626 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6627 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6628 .B 4mv\ \ \ \
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6629 Use 4 motion vectors per macroblock.
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
6630 This might give better compression, but slows down encoding.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6631 .br
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6632 .I WARNING:
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6633 As of XviD-1.0.x, this option is no longer available separately, and its
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6634 functionality is included in the me_quality option.
13257
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6635 When me_quality > 4, 4mv is activated.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6636 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6637 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6638 .B rc_reaction_delay_factor=<value>
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6639 This parameter controls the number of frames the CBR rate controller
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6640 will wait before reacting to bitrate changes and compensating for them
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6641 to obtain a constant bitrate over an averaging range of frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6642 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6643 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6644 .B rc_averaging_period=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6645 Real CBR is hard to achieve.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6646 Depending on the video material, bitrate can be variable, and hard to predict.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6647 That's why XviD uses an averaging period for which it guarantees a given
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6648 amount of bits (minus a small variation).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6649 This settings expresses the "number of frames" for which XviD averages
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6650 bitrate and tries to achieve CBR.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6651 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6652 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6653 .B rc_buffer=<value>
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
6654 size of the rate control buffer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6655 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6656 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6657 .B quant_range=<1\-31>\-<1\-31>[/\:<1\-31>\-<1\-31>]
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6658 CBR mode: min & max quantizer for all frames (default: 2\-31)
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6659 .br
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6660 2pass mode: min & max quantizer for I/\:P-frames (default: 2\-31/\:2\-31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6661 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6662 .I WARNING:
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6663 As of XviD-1.0.x, this option is replaced by the
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6664 [min|max]_[i|p|b]quant options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6665 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6666 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6667 .B min_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6668 minimum interval between keyframes (default: 0, 2pass only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6669 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6670 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6671 .B max_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6672 maximum interval between keyframes (default: 10*fps)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6673 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6674 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6675 .B mpeg_quant
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6676 Use MPEG quantizers instead of H.263.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6677 For high bitrates, you will find that MPEG quantization preserves more detail.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6678 For low bitrates, the smoothing of H.263 will give you less block noise.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6679 When using custom matrices, MPEG must be used.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6680 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6681 .I WARNING:
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6682 As of XviD-1.0.x, this option is replaced by the quant_type option.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6683 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6684 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6685 .B mod_quant
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6686 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6687 (2pass mode only).
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6688 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6689 .I WARNING:
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6690 This will generate an illegal bitstream, and most likely not be decodable
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
6691 by any MPEG-4 decoder besides libavcodec or XviD.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6692 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6693 .I WARNING:
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6694 As of XviD-1.0.x, this option is no longer available.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6695 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6696 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6697 .B keyframe_boost=<0\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6698 Shift some bits from the pool for other frame types to intra frames,
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6699 thus improving keyframe quality.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6700 (default: 0, 2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6701 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6702 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6703 .B kfthreshold=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6704 (default: 10, 2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6705 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6706 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6707 .B kfreduction=<0\-100>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6708 The above two settings can be used to adjust the size of keyframes that
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6709 you consider too close to the first (in a row).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6710 kfthreshold sets the range in which keyframes are reduced, and
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6711 kfreduction determines the bitrate reduction they get.
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6712 The last I-frame will get treated normally.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6713 (default: 30, 2pass mode only)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6714 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6715 .TP
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6716 .B divx5bvop
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6717 Generate DivX5 compatible B-frames (default: on).
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6718 This seems to be mandatory only for old versions of DivX's decoder.
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6719 .br
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6720 .I WARNING:
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6721 As of XviD-1.0.x, this option is replaced by the closed_gop option.
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6722 .
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6723 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6724 .B (no)greyscale
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6725 Make XviD discard chroma planes so the encoded video is greyscale only.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6726 Note that this does not speed up encoding, it just prevents chroma data
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6727 from being written in the last stage of encoding.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6728 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6729 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6730 .B debug\ \
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6731 Save per-frame statistics in ./xvid.dbg. (This is not the 2pass control
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6732 file.)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
6733 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6734 .
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6735 .PP
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
6736 .sp 1
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
6737 The following options are only available with the latest stable
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6738 releases of XviD 1.0.x (api4).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6739 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6740 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6741 .B (no)packed
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6742 This option is meant to solve frame-order issues when encoding to
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6743 container formats like AVI that cannot cope with out-of-order frames.
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
6744 In practice, most decoders (both software and hardware) are able to deal
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6745 with frame-order themselves, and may get confused when this option is
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6746 turned on, so you can safely leave if off, unless you really know what
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6747 you are doing.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
6748 .br
9818
rguyom
parents: 9809
diff changeset
6749 .I WARNING:
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6750 This will generate an illegal bitstream, and will not be
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
6751 decodable by ISO-MPEG-4 decoders except DivX/\:libavcodec/\:XviD.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
6752 .br
9818
rguyom
parents: 9809
diff changeset
6753 .I WARNING:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6754 This will also store a fake DivX version in the file so the bug
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6755 autodetection of some decoders might be confused.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6756 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6757 .TP
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6758 .B max_bframes=<0\-4>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6759 Maximum number of B-frames to put between I/\:P-frames (default: 0).
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6760 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6761 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6762 .B bquant_ratio=<0\-1000>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6763 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6764 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6765 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6766 .B bquant_offset=<-1000\-1000>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6767 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6768 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6769 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6770 .B bf_threshold=<-255\-255>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6771 Sometimes B-frames do not look good, and introduce artifacts when most of
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6772 the frame is static and some small zones have high motion (in a static
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6773 scene with a man talking, his mouth will probably look bad if what is
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6774 surrounding the man and his mouth is completely static).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6775 This setting allows you to specify what priority to place on the use of
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6776 B-frames.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6777 The higher the value, the higher the probability of B-frames being used.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6778 (default: 0)
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6779 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6780 .TP
13894
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6781 .B (no)closed_gop
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6782 This option tells XviD to close every GOP (Group Of Pictures bounded
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6783 by two I-frames), which makes GOPs independent from each other.
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6784 This just implies that the last frame of the GOP is eiter a P-frame or a
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6785 N-frame but not a B-frame.
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6786 It is usually a good idea to turn this option on (default: on).
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6787 .
7f22fdc992a4 Some work on the XviD section:
gpoirier
parents: 13853
diff changeset
6788 .TP
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6789 .B frame_drop_ratio=<0\-100> (max_bframes=0 only)
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6790 This setting allows the creation of variable framerate video streams.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6791 The value of the setting specifies a threshold under which, if the
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6792 difference of the following frame to the previous frame is below or equal
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6793 to this threshold, a frame gets not coded (a so called n-vop is placed
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6794 in the stream).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6795 On playback, when reaching an n-vop the previous frame will be displayed.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6796 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6797 .I WARNING:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6798 Playing with this setting may result in a jerky video, so use it at your
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6799 own risks!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6800 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6801 .TP
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
6802 .B (no)qpel
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
6803 MPEG-4 uses a half pixel precision for its motion search by default.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6804 The standard proposes a mode where encoders are allowed to use quarter
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6805 pixel precision.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6806 This option usually results in a sharper image.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6807 Unfortunately it has a great impact on bitrate and sometimes the
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6808 higher bitrate use will prevent it from giving a better image
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6809 quality at a fixed bitrate.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6810 It's better to test with and without this option and see whether it
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6811 is worth activating.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6812 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6813 .TP
13959
91b6a78856e5 miscellaneous fixes
diego
parents: 13933
diff changeset
6814 .B (no)gmc
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6815 Enable Global Motion Compensation, which makes XviD generate special
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6816 frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images.
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
6817 Whether or not the use of this option will save bits is highly
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
6818 dependent on the source material.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6819 .
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6820 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6821 .B (no)trellis
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6822 Trellis Quantization is a kind of adaptive quantization method that
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6823 saves bits by modifying quantized coefficients to make them more
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6824 compressible by the entropy encoder.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6825 Its impact on quality is good, and if VHQ uses too much CPU for you,
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6826 this setting can be a good alternative to save a few bits (and gain
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6827 quality at fixed bitrate) at a lesser cost than with VHQ.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6828 .
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6829 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6830 .B (no)cartoon
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6831 Activate this if your encoded sequence is an anime/\:cartoon.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6832 It modifies some XviD internal thresholds so XviD takes better decisions on
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6833 frame types and motion vectors for flat looking cartoons.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6834 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6835 .TP
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6836 .B quant_type=<h263|mpeg>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6837 Sets the type of quantizer to use.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6838 For high bitrates, you will find that MPEG quantization preserves more detail.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6839 For low bitrates, the smoothing of H.263 will give you less block noise.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6840 When using custom matrices, MPEG quantization must be used.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6841 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6842 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6843 .B (no)chroma_me
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6844 The usual motion estimation algorithm uses only the luminance information to
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6845 find the best motion vector.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6846 However for some video material, using the chroma planes can help find
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6847 better vectors.
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6848 This setting toggles the use of chroma planes for motion estimation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6849 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6850 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6851 .B (no)chroma_opt
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6852 Enable a chroma optimizer prefilter.
13053
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6853 It will do some extra magic on color information to minimize the
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6854 stepped-stairs effect on edges.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6855 It will improve quality at the cost of encoding speed.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6856 It reduces PSNR by nature, as the mathematical deviation to the original
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6857 picture will get bigger, but the subjective image quality will raise.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6858 Since it works with color information, you might want to turn it off when
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6859 encoding in greyscale.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6860 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6861 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
6862 .B (no)hq_ac
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6863 Activates High Quality AC coefficient prediction from neighbor blocks.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6864 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6865 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6866 .B vhq=<0\-4>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6867 The motion search algorithm is based on a search in the usual color domain
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6868 and tries to find a motion vector that minimizes the difference between the
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6869 reference frame and the encoded frame.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6870 With this setting activated, XviD will also use the frequency domain (DCT)
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6871 to search for a motion vector that minimizes not only the spatial
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6872 difference but also the encoding length of the block.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6873 Fastest to slowest:
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6874 .PD 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6875 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6876 .IPs 0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6877 off (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6878 .IPs 1
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6879 mode decision (inter/\:intra MB)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6880 .IPs 2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6881 limited search
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6882 .IPs 3
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6883 medium search
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6884 .IPs 4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6885 wide search
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6886 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6887 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6888 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6889 .TP
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6890 .B min_iquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6891 minimum I-frame quantizer (default: 2)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6892 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6893 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6894 .B max_iquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6895 maximum I-frame quantizer (default: 31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6896 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6897 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6898 .B min_pquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6899 minimum P-frame quantizer (default: 2)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6900 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6901 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6902 .B max_pquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6903 maximum P-frame quantizer (default: 31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6904 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6905 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6906 .B min_bquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6907 minimum B-frame quantizer (default: 2)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6908 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6909 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6910 .B max_bquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6911 maximum B-frame quantizer (default: 31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6912 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6913 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6914 .B quant_intra_matrix=<filename>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6915 Load a custom intra matrix file.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6916 You can build such a file with xvid4conf's matrix editor.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6917 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6918 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6919 .B quant_inter_matrix=<filename>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6920 Load a custom inter matrix file.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6921 You can build such a file with xvid4conf's matrix editor.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6922 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6923 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6924 .B curve_compression_high=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6925 This setting allows XviD to take a certain percentage of bits away from
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6926 high bitrate scenes and give them back to the bit reservoir.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6927 You could also use this if you have a clip with so many bits allocated
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6928 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6929 (default: 0).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6930 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6931 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6932 .B curve_compression_low=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6933 This setting allows XviD to give a certain percentage of extra bits to the
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6934 low bitrate scenes, taking a few bits from the entire clip.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6935 This might come in handy if you have a few low-bitrate scenes that are
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6936 still blocky (default: 0).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6937 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6938 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6939 .B overflow_control_strength=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6940 During pass 1 of 2-pass encoding, a scaled bitrate curve is computed.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6941 The difference between that expected curve and the result obtained during
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6942 encoding is called overflow.
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6943 Obviously, the two pass rate controller tries to compensate for that overflow,
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6944 distributing it over the next frames.
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6945 This setting controls how much of the overflow is distributed every time
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6946 there is a new frame.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6947 Low values allow lazy overflow control, big rate bursts are compensated for
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6948 more slowly (could lead to lack of precision for small clips).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6949 Higher values will make changes in bit redistribution more abrupt, possibly
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6950 too abrupt if you set it too high, creating artifacts (default: 5).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6951 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6952 .I NOTE:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6953 This setting impacts quality a lot, play with it carefully!
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6954 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6955 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6956 .B max_overflow_improvement=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6957 During the frame bit allocation, overflow control may increase the frame
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6958 size.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6959 This parameter specifies the maximum percentage by which the overflow
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6960 control is allowed to increase the frame size, compared to the ideal curve
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6961 allocation
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6962 (default: 5).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6963 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6964 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6965 .B max_overflow_degradation=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6966 During the frame bit allocation, overflow control may decrease the frame
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6967 size.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6968 This parameter specifies the maximum percentage by which the overflow
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6969 control is allowed to decrease the frame size, compared to the ideal curve
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6970 allocation
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6971 (default: 5).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6972 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6973 .TP
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6974 .B container_frame_overhead=<0...>
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6975 Specifies a frame average overhead per frame, in bytes.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6976 Most of the time users express their target bitrate for video w/o taking
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6977 care of the video container overhead.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6978 This small but (mostly) constant overhead can cause the target file size
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6979 to be exceeded.
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6980 XviD allows users to set the amount of overhead per frame the
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6981 container generates (give only an average per frame).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6982 0 has a special meaning, it lets XviD use its own default values
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6983 (default: 24 - AVI average overhead).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6984 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6985 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6986 .B par=<mode>
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6987 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR,
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6988 the Display Aspect Ratio).
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6989 PAR is the ratio of the width and height of a single pixel.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6990 So both are related like this: DAR = PAR * (width/height).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6991 .br
14024
0d9e27059495 MPEG-X spelling
diego
parents: 14003
diff changeset
6992 MPEG-4 defines 5 pixel aspect ratios and one extended
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6993 one, giving the opportunity to specify a specific pixel aspect
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6994 ratio.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6995 5 standard modes can be specified:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6996 .PD 0
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6997 .RSs
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6998 .IPs vga11
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6999 It's the usual PAR for PC content.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7000 Pixels are a square unit.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7001 .IPs pal43
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7002 PAL standard 4:3 PAR.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7003 Pixels are rectangles.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7004 .IPs pal169
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7005 same as above
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7006 .IPs ntsc43
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7007 same as above
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7008 .IPs ntsc169
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7009 same as above (Don't forget to give the exact ratio.)
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7010 .IPs ext\ \
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7011 Allows you to specify your own pixel aspect ratio with par_width and
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7012 par_height.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7013 .RE
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7014 .PD 1
14182
584551fb6586 Fix paragraph indentation.
diego
parents: 14180
diff changeset
7015 .RS
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7016 .I NOTE:
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7017 In general, setting aspect and autoaspect options is enough.
14182
584551fb6586 Fix paragraph indentation.
diego
parents: 14180
diff changeset
7018 .RE
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7019 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7020 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7021 .B par_width=<1\-255> (par=ext only)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7022 Specifies the width of the custom pixel aspect ratio.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7023 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7024 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7025 .B par_height=<1\-255> (par=ext only)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7026 Specifies the height of the custom pixel aspect ratio.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7027 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
7028 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
7029 .B aspect=<x/\:y | f (float value)>
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7030 Store movie aspect internally, just like MPEG files.
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7031 Much nicer solution than rescaling, because quality isn't decreased.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
7032 MPlayer and a few others players will play these files correctly, others
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
7033 will display them with the wrong aspect.
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7034 The aspect parameter can be given as a ratio or a floating point number.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7035 .
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7036 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
7037 .B (no)autoaspect
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7038 Same as the aspect option, but automatically computes aspect, taking
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
7039 into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7040 filter chain.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7041 .
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
7042 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
7043 .B psnr\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7044 Print the PSNR (peak signal to noise ratio) for the whole video after encoding
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7045 and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
7046 the current directory.
9809
508dc4231269 Actually do something useful with XVID_GLOBAL_EXTRASTATS / XVID_EXTRASTATS.
rguyom
parents: 9808
diff changeset
7047 Returned values are in dB (decibel), the higher the better.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7048 .
13613
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7049 .PP
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7050 .sp 1
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7051 The following option is only available in development versions
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7052 of XviD 1.1.x.
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7053 .
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7054 .TP
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7055 .B bvhq=<0|1>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7056 This setting allows vector candidates for B-frames to be used for
13613
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7057 the encoding chosen using a rate distortion optimized operator,
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7058 which is what is done for P-frames by the vhq option.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7059 This produces nicer-looking B-frames while incurring almost no
13613
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7060 performance penalty.
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
7061 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7062 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7063 .SS x264enc (\-x264encopts)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7064 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7065 .TP
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7066 .B bitrate=<value>
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7067 Sets the bitrate to be used in kbits/\:second (default: off).
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7068 This is required if you want a CBR (constant bitrate) encode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7069 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7070 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7071 .B keyint=<value>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7072 Sets maximum interval between I-frames.
13456
25519a9feab0 Better x264 descriptions/fixes based on Loren Merritt's patch (Thu, 23 Sep 2004)
gpoirier
parents: 13452
diff changeset
7073 Larger values save bits, thus improve quality, at the cost of seeking
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7074 precision (default: 250).
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7075 .
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7076 .TP
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7077 .B idrint=<value>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7078 Make each <value> I-frame an IDR-frame (default: 2).
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7079 In H.264, I-frames do not necessarily bound a closed GOP because it is
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7080 allowable for a P-frame to be predicted from more frames than just the one
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7081 frame before it (also see frameref).
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7082 Therefore, I-frames are not necessarily seekable.
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7083 IDR-frames restrict subsequent P-frames from referring to any frame
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7084 prior to the IDR-frame.
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7085 .
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7086 .TP
13584
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7087 .B scenecut=<-1\-100>
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7088 Controls how aggressively to insert extra I-frames (default: 40).
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7089 With small values of scenecut, the codec often has to force an I-frame
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7090 when it would exceed keyint.
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7091 Good values of scenecut may find a better location for the I-frame.
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7092 Large values use more I-frames than necessary, thus wasting bits.
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
7093 -1 disables scene-cut detection, so I-frames are inserted only once
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
7094 every other keyint frames, even if a scene-cut occurs earlier.
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
7095 This isn't recommended and wastes bitrate as scenecuts encoded as P-frames
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
7096 are just as big as I-frames, but don't reset the "keyint counter".
13584
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7097 .
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
7098 .TP
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7099 .B frameref=<1\-15>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7100 Number of previous frames used as predictors in a P-frame (default: 1).
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7101 This is effective in Anime, but seems to make little difference in
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7102 live-action source material.
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7103 Some decoders are unable to deal with large frameref values.
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7104 .
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
7105 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7106 .B bframes=<0\-16>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7107 number of consecutive B-frames between I- and P-frames (default: 0)
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7108 .
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7109 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
7110 .B (no)deblock
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7111 Use deblocking filter (default: on).
13472
c85ea936d411 Encoding tip regarding x264's deblock filter suggested by Loren Merritt.
gpoirier
parents: 13469
diff changeset
7112 As it takes very little time compared to its quality gain, it's not
c85ea936d411 Encoding tip regarding x264's deblock filter suggested by Loren Merritt.
gpoirier
parents: 13469
diff changeset
7113 recommend to disable it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7114 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
7115 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7116 .B deblockalpha=<-6\-6>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7117 AlphaC0 parameter of deblocking filter (default: 0).
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7118 This adjusts thresholds for the H.264 deblocking filter.
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7119 First, this parameter adjusts the maximum amount of change that the filter is
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7120 allowed to cause on any one pixel.
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7121 Secondly, this parameter affects the threshold for difference across the
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7122 edge being filtered.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7123 A positive value reduces blocking artifacts more, but will also smear details.
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7124 .br
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7125 For encodes that are intended to be reasonably high quality, you might
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7126 want to turn it down a little bit.
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7127 However, if your source material already has some blocking or noise
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7128 which you would like to remove, or if it is animation, it may be a good
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7129 idea to turn it up a little bit.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7130 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7131 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7132 .B deblockbeta=<-6\-6>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7133 Beta parameter of deblocking filter (default: 0).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7134 Affects the maximum allowed gradient within two adjacent blocks.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7135 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7136 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
7137 .B (no)cabac
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7138 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on).
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7139 Slightly slows down encoding and decoding, but should save 10-15% bitrate.
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7140 Unless you are looking for speed, you should not disable it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7141 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
7142 .TP
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7143 .B cabacidc=<value>
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7144 Initial value of CABAC IDC.
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7145 The encoder must choose a context for each block it encodes, but for the
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7146 first block in a frame, there are no prior blocks to predict the context.
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7147 Adjusting this may affect bitrate by a fraction of a percent, but it doesn't
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7148 directly affect distortion.
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7149 .RSs
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7150 -1: Encoder chooses context, usually 0 (default).
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7151 .br
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7152 0: low complexity
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7153 .br
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7154 1: medium complexity
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7155 .br
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7156 2: high complexity
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7157 .REss
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7158 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7159 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7160 .B qp_constant=<1\-51>
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7161 This selects the quantizer to use.
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7162 20\-40 is a useful range (default: 26).
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7163 Lower values result in better fidelity, but higher bitrates.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7164 Note that quantization in H.264 works differently from MPEG[124].
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
7165 H.264's quantization parameter (QP) is on a logarithmic scale.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7166 As an example, the bitrate difference between QP=20 and QP=40
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7167 is about a factor of 10.
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7168 Useful quantizers in H.264 tend to be very large compared to MPEG[124].
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7169 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7170 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7171 .B qp_min=<1\-51> (CBR or 2 pass)
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7172 Minimum quantizer, 15\-35 seems to be a useful range (default: 10).
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7173 .
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7174 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7175 .B qp_max=<1\-51> (CBR or 2 pass)
13325
f26d2c9aec04 2pass encoding support for x264(r46).
iive
parents: 13319
diff changeset
7176 maximum quantizer (default: 51)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7177 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7178 .TP
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7179 .B qp_step=<value>
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7180 Maximum Value by which the quantizer may be incremented/decremented between
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7181 frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7182 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7183 .TP
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7184 .B rc_buffer_size=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7185 ratecontrol buffer size (default: 1 second's worth at the bitrate you
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7186 specified)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7187 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7188 .TP
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7189 .B rc_init_buffer=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7190 Set the initial ratecontrol buffer (default: 1/4 of rc_buffer_size)
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7191 .
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7192 .TP
13456
25519a9feab0 Better x264 descriptions/fixes based on Loren Merritt's patch (Thu, 23 Sep 2004)
gpoirier
parents: 13452
diff changeset
7193 .B rc_sens=<0\-100> (CBR only)
13325
f26d2c9aec04 2pass encoding support for x264(r46).
iive
parents: 13319
diff changeset
7194 ratecontrol sensitivity (default: 4)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7195 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7196 .TP
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7197 .B ip_factor=<value>
13965
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7198 quantizer factor between I- and P-frames (default: 1.4)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7199 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7200 .TP
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7201 .B pb_factor=<value>
14259
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7202 quantizer factor between P- and B-frames (default: 1.3)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7203 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7204 .TP
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7205 .B pass=<1\-3>
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7206 Enable 2 or 3-pass mode.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7207 It is recommended to always encode in 2 or 3-pass mode as it leads to a
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7208 better bit distribution and improves overall quality.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7209 .PD 0
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7210 .RSs
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7211 .IPs 1
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7212 first pass
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7213 .IPs 2
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7214 second pass
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7215 .IPs 3
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7216 Nth pass (second and third passes of three pass encoding)
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7217 .RE
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7218 .RS
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7219 Here is how it works, and how to use it:
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7220 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7221 The first pass (pass=1) collects statistics on the video and writes them
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7222 to a file.
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
7223 You might want to deactivate some CPU-hungry options, apart from the ones
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7224 that are on by default.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7225 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7226 In two pass mode, the second pass (pass=2) reads the stats file and
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7227 bases ratecontrol decisions on it.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7228 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7229 In three pass mode, the second pass (pass=3, that is not a typo)
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7230 does both: It first reads the stats, then overwrites them.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7231 You might want to backup divx2pass.log before doing this if there is
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7232 any possibility that you will have to cancel MEncoder.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7233 You can use all encoding options, except very CPU-hungry options.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7234 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7235 The third pass (pass=3) is the same as the second pass, except that it has
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7236 the second pass' stats to work from.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7237 You can use all encoding options, including CPU-hungry ones.
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
7238 .br
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7239 .I
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7240 NOTE:
13545
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7241 x264 three pass support being quite recent in MEncoder, we welcome any
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7242 feedback you could give us on good combinations of x264 options that are
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7243 both fast and provide good quality.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7244 .REss
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7245 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7246 .TP
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7247 .B qcomp=<0\-1>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7248 quantizer compression (default: 0.6).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7249 This affects the ratecontrol: a lower value makes the
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7250 bitrate more constant, while a higher value makes the quantization parameter
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7251 more constant.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7252 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7253 .TP
13965
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7254 .B cplx_blur=<0\-999>
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7255 Temporal blur of the estimated frame complexity, before curve compression
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7256 (default: 20).
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7257 Lower values allow the quantizer value to jump around more,
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7258 higher values force it to vary more smoothly.
13965
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7259 cplx_blur ensures that each I-frame has quality comparable to the following
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7260 P-frames, and ensures that alternating high and low complexity frames
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7261 (e.g. low fps animation) do not waste bits on fluctuating quantizer.
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7262 .
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7263 .TP
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7264 .B qblur=<0\-99>
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7265 Temporal blur of the quantization parameter, after curve compression
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7266 (default: 0.5).
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7267 Lower values allow the quantizer value to jump around more,
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7268 higher values force it to vary more smoothly.
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7269 .
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7270 .TP
14259
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7271 .B direct_pred=<0\-2>
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7272 Determines the type of motion prediction used for direct macroblocks
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7273 in B-frames.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7274 .PD 0
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7275 .RSs
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7276 .IPs 0
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7277 None: direct macroblocks are not used.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7278 .IPs 1
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7279 Temporal: motion vectors are interpolated from the following P-frame.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7280 .IPs 2
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7281 Spatial: motion vectors are extrapolated from neighboring blocks.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7282 .RE
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7283 .PD 1
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7284 Spatial and temporal are approximately the same speed, and neither is
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7285 strictly better than the other.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7286 The best choice depends on the movie.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7287 direct_pred=0 is usually both slower and lower quality.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7288 .
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7289 .TP
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7290 .B (no)b8x8mv
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7291 Use macroblock types b16x8, b8x16, b8x8 (default: enabled).
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7292 Requires B-frames.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7293 See 4x4mv for details.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7294 .
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7295 .TP
13965
b825bd2efe14 sync to x264 r61 (improved 2pass ratecontrol)
lorenm
parents: 13959
diff changeset
7296 .B (no)4x4mv
14259
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7297 Use macroblock types p8x4, p4x8, p4x4 (default: disabled).
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7298 .br
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7299 The available interframe macroblock types are i16x16, i4x4, p16x16, p16x8,
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7300 p8x16, p8x8, p8x4, p4x8, p4x4, b16x16, b16x8, b8x16, b8x8, skip, direct.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7301 i16x16, i4x4, p16x16-8x8, b16x16, and skip are always used.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7302 .br
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
7303 The idea is to find the type and size that best describe a certain area
14259
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7304 of the picture.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7305 For example, a global pan is better represented by 16x16 blocks, while
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7306 small moving objects are better represented by smaller blocks.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7307 .br
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7308 4x4mv is recommended only with subq >= 3.
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7309 Depending on the source material, it can improve or degrade
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7310 quality, use it with care.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7311 .
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7312 .TP
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7313 .B subq=<0\-5>
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7314 Adjust subpel refinement quality.
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7315 This parameter controls quality versus speed tradeoffs involved in the motion
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7316 estimation decision process.
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7317 It can improve quality significantly.
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7318 .RSs
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7319 0: halfpel only
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7320 .br
14259
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7321 1: 1 iteration of qpel on the winning candidate
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7322 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7323 2: 2 iterations of qpel on the winning candidate
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7324 .br
14259
0126a2f79310 new x264 options: b8x8mv, direct_pred
lorenm
parents: 14234
diff changeset
7325 3: halfpel on all MB types, qpel on the winner (default)
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7326 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7327 4: qpel on all
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7328 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7329 5: more iterations of qpel
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7330 .REss
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7331 .
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7332 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7333 .B log=<-1\-3>
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7334 Adjust the amount of logging info printed to the screen.
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7335 .RSs
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7336 -1: none
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7337 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7338 0: Print errors only.
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7339 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7340 1: warnings
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7341 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7342 2: PSNR, encoding times, and other analysis stats when the encode finishes
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7343 (default)
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7344 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7345 3: PSNR, QP, frametype, size, and other stats for every frame
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7346 .REss
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7347 .
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7348 .TP
13853
5a786c7e4df4 have each XviD's option flag have its (no)counterpart
gpoirier
parents: 13844
diff changeset
7349 .B (no)psnr
13545
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7350 Print signal-to-noise ratio statistics.
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7351 .br
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7352 .I NOTE:
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7353 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7354 mathematically sound (they are simply the average of per-frame PSNRs).
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7355 They are kept only for comparison to the JM reference codec.
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7356 For all other purposes, please use either the 'Global' PSNR, or the per-frame
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7357 PSNRs printed by log=3.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7358 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7359 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7360 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7361 .\" Files
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7362 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7363 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7364 .SH FILES
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7365 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7366 .TP
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
7367 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
7368 system-wide settings
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7369 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7370 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7371 ~/.mplayer/\:config
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7372 user settings
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7373 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7374 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7375 ~/.mplayer/\:input.conf
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7376 input bindings (see '\-input keylist' for the full list)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7377 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7378 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7379 ~/.mplayer/\:gui.conf
7108
3284ffd653b3 added detailed vop description, rtsp, aid range, user option, two examples, files documentation - removed gui option, *_intensity options, old input system (Joey Parrish)
jonas
parents: 7070
diff changeset
7380 GUI configuration file
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7381 .
7108
3284ffd653b3 added detailed vop description, rtsp, aid range, user option, two examples, files documentation - removed gui option, *_intensity options, old input system (Joey Parrish)
jonas
parents: 7070
diff changeset
7382 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7383 ~/.mplayer/\:gui.pl
7108
3284ffd653b3 added detailed vop description, rtsp, aid range, user option, two examples, files documentation - removed gui option, *_intensity options, old input system (Joey Parrish)
jonas
parents: 7070
diff changeset
7384 GUI playlist
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7385 .
7108
3284ffd653b3 added detailed vop description, rtsp, aid range, user option, two examples, files documentation - removed gui option, *_intensity options, old input system (Joey Parrish)
jonas
parents: 7070
diff changeset
7386 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7387 ~/.mplayer/\:font/
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7388 font directory (There must be a font.desc file and files with .RAW extension.)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7389 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7390 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7391 ~/.mplayer/\:DVDkeys/
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
7392 cached CSS keys
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7393 .
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
7394 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7395 Assuming that /path/\:to/\:movie.avi is played, MPlayer searches for sub files
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7396 in this order:
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
7397 .RS
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7398 /path/\:to/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
7399 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7400 ~/.mplayer/\:sub/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
7401 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7402 ~/.mplayer/\:default.sub
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
7403 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
7404 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7405 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7406 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7407 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7408 .\" Examples
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7409 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7410 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7411 .SH EXAMPLES
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7412 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7413 .TP
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
7414 .B Quickstart DVD playing:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7415 mplayer dvd://1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7416 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7417 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7418 .B Play in Japanese with English subtitles:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7419 mplayer dvd://1 \-alang ja \-slang en
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7420 .
7108
3284ffd653b3 added detailed vop description, rtsp, aid range, user option, two examples, files documentation - removed gui option, *_intensity options, old input system (Joey Parrish)
jonas
parents: 7070
diff changeset
7421 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7422 .B Play only chapters 5, 6, 7:
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
7423 mplayer dvd://1 \-chapter 5-7
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7424 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7425 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7426 .B Play only titles 5, 6, 7:
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
7427 mplayer dvd://5-7
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7428 .
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
7429 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7430 .B Play a multiangle DVD:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7431 mplayer dvd://1 \-dvdangle 2
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7432 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7433 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7434 .B Play from a different DVD device:
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
7435 mplayer dvd://1 \-dvd-device /dev/\:dvd2
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7436 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7437 .TP
13510
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7438 .B Play DVD video from a directory with VOB files:
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7439 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7440 .
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7441 .TP
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7442 .B Copy a DVD title to hard disk, saving to file "title1.vob":
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7443 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7444 .
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7445 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7446 .B Stream from HTTP:
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7447 mplayer http://mplayer.hq/\:example.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7448 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7449 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7450 .B Stream using RTSP:
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
7451 mplayer rtsp://server.example.com/\:streamName
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7452 .
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
7453 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7454 .B Convert subtitles to MPsub format:
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
7455 mplayer dummy.avi \-sub source.sub \-dumpmpsub
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7456 .
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
7457 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7458 .B Convert subtitles to MPsub format without watching the movie:
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
7459 mplayer /dev/\:zero \-rawvideo on:pal:fps=xx \-vc null \-vo null \-noframedrop
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7460 \-benchmark \-sub source.sub \-dumpmpsub
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7461 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7462 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7463 .B input from standard V4L:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7464 mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
7465 \-vo xv
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7466 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7467 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7468 .B Playback on Zoran cards (old style, deprecated):
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
7469 mplayer \-vo zr \-vf scale=352:288 file.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7470 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
7471 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7472 .B Playback on Zoran cards (new style):
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
7473 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7474 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
7475 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7476 .B Encode DVD title #2, only selected chapters:
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
7477 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7478 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7479 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7480 .B Encode DVD title #2, resizing to 640x480:
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
7481 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7482 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7483 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7484 .B Encode DVD title #2, resizing to 512xHHH (keep aspect ratio):
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7485 mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
7486 \-ovc lavc \-lavcopts vcodec=mpeg4
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7487 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7488 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7489 .B The same, but with bitrate set to 1800kBit and optimized macroblocks:
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7490 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7491 \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7492 .
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7493 .TP
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
7494 .B The same, but with MJPEG compression:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7495 mencoder dvd://2 \-o titel2.avi \-ovc lavc
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7496 \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 \-oac copy
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7497 .
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7498 .TP
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7499 .B Encode all *.jpg files in the current dir:
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
7500 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7501 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7502 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7503 .B Encode from a tuner (specify a format with \-vf format):
11966
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
7504 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7505 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7506 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7507 .B Encode from a pipe:
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
7508 rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \-
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7509 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7510 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7511 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7512 .\" Bugs, authors, standard disclaimer
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7513 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7514 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7515 .SH BUGS
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7516 If you find one, report it to us, but please make sure you have read all
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7517 of the documentation first.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7518 Many bugs are the result of incorrect setup or parameter usage.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
7519 The bug reporting section of the documentation (DOCS/\:HTML/\:en/\:bugreports.html)
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7520 explains how to create useful bug reports.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7521 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7522 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7523 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7524 .SH AUTHORS
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7525 MPlayer was initially written by Arpad Gereffy.
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7526 See the AUTHORS file for a list of some of the many other contributors.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7527 .PP
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7528 MPlayer is (C) 2000\-2004 The MPlayer Team
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7529 .PP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7530 This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7531 It is maintained by Diego Biurrun.
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7532 Please send mails about it to the MPlayer-DOCS mailing list.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
7533 .\" end of file