annotate DOCS/man/en/mplayer.1 @ 13261:42992a398551

-lavdopts fast, small fix to -lavdopts ec
author diego
date Mon, 06 Sep 2004 11:03:51 +0000
parents cf4c3b32c4d7
children 8d4a16cb1e97
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 .
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
36 .TH MPlayer 1 "2004-08-27" "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).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
186 It encodes to DivX4, XviD, one of the libavcodec codecs and PCM/\:MP3/\:VBRMP3
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
187 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
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
196 .B Also see the HTML documentation!
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
197 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
198 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
199 .\" --------------------------------------------------------------------------
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
200 .\" Keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
201 .\" --------------------------------------------------------------------------
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
202 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
203 .SH "KEYBOARD CONTROL"
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
204 MPlayer has a fully configurable, command-driven control layer
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
205 which allows you to control MPlayer using keyboard, mouse, joystick
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
206 or remote control (with LIRC).
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
207 See the \-input option for ways to customize it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
208 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
209 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
210 .B general control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
211 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
212 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
213 .IPs "<\- and \->"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
214 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
215 .IPs "up and down"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
216 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
217 .IPs "pgup and pgdown"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
218 Seek backward/\:forward 10 minutes.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
219 .IPs "< and >"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
220 backward/\:forward in playlist
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
221 .IPs "HOME and END"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
222 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
223 .IPs "INS and DEL"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
224 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
225 .IPs "p / SPACE"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
226 Pause movie (any key unpauses).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
227 .IPs "q / ESC"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
228 Stop playing and quit.
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
229 .IPs "+ and -"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
230 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
231 .IPs "/ and *"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
232 Decrease/\:increase volume.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
233 .IPs "9 and 0"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
234 Decrease/\:increase volume.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
235 .IPs m\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
236 Mute sound.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
237 .IPs f\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
238 Toggle fullscreen (also see \-fs).
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
239 .IPs T\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
240 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
241 .IPs "w and e"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
242 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
243 .IPs o\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
244 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
245 .IPs d\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
246 Toggle frame dropping states: none / skip display / skip decoding
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
247 (see \-framedrop and \-hardframedrop).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
248 .IPs v\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
249 Toggle subtitle visibility.
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
250 .IPs "b / j"
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
251 Cycle through the available subtitles.
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
252 .IP F\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
253 Toggle displaying "forced subtitles".
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
254 .IPs a\ \ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
255 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
256 .IPs "z and x"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
257 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
258 .IPs "r and t"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
259 Move subtitles up/\:down.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
260 .IPs i\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
261 Set EDL mark.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
262 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
263 .PD 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
264 .PP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
265 (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
266 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
267 (\-vf eq or \-vf eq2).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
268 .PP
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
269 .PD 0
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
270 .RSs
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
271 .IPs "1 and 2"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
272 Adjust contrast.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
273 .IPs "3 and 4"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
274 Adjust brightness.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
275 .IPs "5 and 6"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
276 Adjust hue.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
277 .IPs "7 and 8"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
278 Adjust saturation.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
279 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
280 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
281 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
282 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
283 .B GUI keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
284 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
285 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
286 .IPs ENTER
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
287 Start playing.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
288 .IPs s\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
289 Stop playing.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
290 .IPs l\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
291 Load file.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
292 .IPs c\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
293 Skin browser.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
294 .IPs p\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
295 Toggle playlist.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
296 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
297 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
298 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
299 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
300 .B TV input control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
301 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
302 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
303 .IPs "h and k"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
304 Select previous/\:next channel.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
305 .IPs n\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
306 Change norm.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
307 .IPs u\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
308 Change channel list.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
309 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
310 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
311 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
312 .
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
313 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
314 .\" Options
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
315 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
316 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
317 .SH "USAGE"
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
318 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
319 \-fs option is \-nofs.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
320 .PP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
321 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
322 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
323 .PP
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
324 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
325 every time MPlayer is run.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
326 The system-wide configuration file 'mplayer.conf' is in your configuration
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
327 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
328 specific one is '~/\:.mplayer/\:config'.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
329 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
330 command line override either.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
331 The syntax of the configuration files is 'option=<value>', everything after
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
332 a '#' is considered a comment.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
333 Options that work without values can be enabled by setting them to 'yes'
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
334 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
335 Even suboptions can be specified in this way.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
336 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
337 .I EXAMPLE:
13159
edeba26483a1 simplification
diego
parents: 13158
diff changeset
338 .nf
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
339 # Use Matrox driver by default.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
340 vo=xmga
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
341 # I love practicing handstands while watching videos.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
342 flip=yes
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
343 # Decode/\:encode multiple files from png,
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
344 # start with mf://filemask
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
345 mf=type=png:fps=25
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
346 # Eerie negative images are cool.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
347 vf=eq2=1.0:-0.8
13159
edeba26483a1 simplification
diego
parents: 13158
diff changeset
348 .fi
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
349 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
350 You can also write file-specific configuration files.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
351 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
352 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
353 ~/.mplayer or in the same directory as the file.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
354 .
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
355 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
356 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
357 .SH "GENERAL OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
358 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
359 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
360 .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
361 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
362 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
363 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
364 .B \-include <configuration\ file>
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
365 Specify configuration file to be parsed after the default ones.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
366 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
367 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
368 .B \-quiet \ \
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
369 Make console output less verbose; in particular, prevents the status line
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
370 (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
371 Particularly useful on slow terminals or broken ones which do not properly
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
372 handle carriage return (i.e.\& \\r).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
373 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
374 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
375 .B \-v, \-verbose
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
376 Increment verbose level (more \-v means more verbosity).
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
377 .PD 0
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
378 .RSs
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
379 .IPs 0
11949
86da102d74d8 slight wording improvement, noticed by Dominik
diego
parents: 11943
diff changeset
380 only some informational output (default)
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
381 .IPs 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
382 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
383 .IPs 2
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
384 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
385 .IPs 3
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
386 prints everything related to input parsers (parser debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
387 .RE
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
388 .PD 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
389 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
390 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
391 .
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
392 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
393 .
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
394 .TP
11448
gabucino
parents: 11446
diff changeset
395 .B \-autoq <quality> (use with \-vf [s]pp)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
396 Dynamically changes the level of postprocessing depending on the available spare
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
397 CPU time.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
398 The number you specify will be the maximum level used.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
399 Usually you can use some big number.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
400 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
401 .
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
402 .TP
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
403 .B \-autosync <factor>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
404 Gradually adjusts the A/\:V sync based on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
405 Specifying \-autosync\ 0, the default, will cause frame timing to be based
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
406 entirely on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
407 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
408 correction algorithm.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
409 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
410 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
411 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
412 Try \-autosync\ 30 to smooth out problems with sound drivers which do
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
413 not implement a perfect audio delay measurement.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
414 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
415 1 or 2\ seconds to settle out.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
416 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
417 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
418 .
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
419 .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
420 .B \-benchmark
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
421 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
422 Use in combination with \-nosound and \-vo null for benchmarking only the
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
423 video codec.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
424 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
425 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
426 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
427 only video (you can think of that as infinite fps).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
428 .
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
429 .TP
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
430 .B \-colorkey <number>
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
431 Changes the colorkey to an RGB value of your choice.
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
432 0x000000 is black and 0xffffff is white.
11224
00e639844c85 colorkeying fixes
alex
parents: 11203
diff changeset
433 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
00e639844c85 colorkeying fixes
alex
parents: 11203
diff changeset
434 xover video out drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
435 .
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
436 .TP
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
437 .B \-nocolorkey
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
438 Disables colorkeying.
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
439 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
440 xover video out drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
441 .
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
442 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
443 .B \-edl <filename> (EDL only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
444 Enables edit decision list (EDL) actions during playback.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
445 Video will be skipped over and audio will be muted and unmuted according to
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
446 the entries in the given file.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
447 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
448 .
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
449 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
450 .B \-edlout <filename> (EDL only)
8552
37dd9f68ab71 - and -use-stdin documented, EDL updates.
diego
parents: 8541
diff changeset
451 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
452 During playback, when the user hits 'i', an entry to skip over the last two
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
453 seconds of playback will be written to the file.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
454 This provides a starting point from which the user can fine-tune EDL entries
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
455 later.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
456 See DOCS/\:HTML/\:en/\:edl.html for details.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
457 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
458 .TP
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
459 .B \-enqueue (GUI only)
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
460 Enqueue files given on the command line in the playlist instead of playing them
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
461 immediately.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
462 .
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
463 .TP
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
464 .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
465 Enforces a fixed video system for multiple files (one (un)initialisation for
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
466 all files).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
467 Therefore only one window will be opened for all files.
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
468 Currently the following drivers are fixed-vo compliant: gl2, mga, svga, x11,
13029
e0d566eae34a dfbmga now fixed-vo compliant, lavc exports field flags.
diego
parents: 13021
diff changeset
469 xmga, xv, xvidix and dfbmga.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
470 .
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
471 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
472 .B \-framedrop (also see \-hardframedrop)
9269
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
473 Skip displaying some frames to maintain A/\:V sync on slow systems.
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
474 Video filters are not applied to such frames.
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
475 For B frames even decoding is skipped completely.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
476 .
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
477 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
478 .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
479 Show short summary of options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
480 .
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
481 .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
482 .B \-hardframedrop
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
483 More intense frame dropping (breaks decoding).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
484 Leads to image distortion!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
485 .
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
486 .TP
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
487 .B \-identify
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
488 Show file parameters in an easily parseable format.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
489 The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
490 (hopefully) shellescapes the filenames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
491 .
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
492 .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
493 .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
494 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
495 Paths are relative to ~/\:.mplayer/.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
496 .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
497 .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
498 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
499 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
500 Available commands are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
501 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
502 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
503 .RSs
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
504 .IPs conf=<filename>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
505 Specify input configuration file other than the default
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
506 ~/\:.mplayer/\:input.conf.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
507 ~/\:.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
508 .IPs ar-delay
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
509 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
510 .IPs ar-rate
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
511 Number of key presses to generate per second on autorepeat.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
512 .IPs keylist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
513 Prints all keys that can be bound to commands.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
514 .IPs cmdlist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
515 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
516 .IPs js-dev
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
517 Specifies the joystick device to use (default: /dev/\:input/\:js0).
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
518 .IPs file\
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
519 Read commands from the given file.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
520 Mostly useful with a FIFO.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
521 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
522 .I NOTE:
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
523 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
524 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
525 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
526 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
527 .
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
528 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
529 .B \-lircconf <filename> (LIRC only)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
530 Specifies a configuration file for LIRC (default: ~/\:.lircrc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
531 .
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
532 .TP
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
533 .B \-list-options
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
534 Prints out all the available options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
535 .
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
536 .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
537 .B \-loop <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
538 Loops movie playback <number> times.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
539 0 means forever.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
540 .
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
541 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
542 .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
543 Turn on OSD menu support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
544 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
545 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
546 .B \-menu-cfg <filename> (OSD menu only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
547 Use an alternative menu.conf.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
548 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
549 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
550 .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
551 Specify the main menu.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
552 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
553 .TP
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
554 .B \-noconsolecontrols
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
555 Prevent MPlayer from reading key events from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
556 Useful when reading data from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
557 This is automatically enabled when \- is found on the command line.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
558 There are situations where you have to set it manually, e.g.\&
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
559 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
560 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
561 loadlist slave commands.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
562 .
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
563 .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
564 .B \-nojoystick
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
565 Turns off joystick support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
566 .
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
567 .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
568 .B \-nolirc
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
569 Turns off LIRC support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
570 .
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
571 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
572 .B \-nomouseinput (X11 only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
573 Disable mouse button press/\:release input (mozplayerxp's context menu relies
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
574 on this option).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
575 .
10761
040c2011aace fixing alphabetic order
gabucino
parents: 10760
diff changeset
576 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
577 .B \-nortc (RTC only)
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
578 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
579 mechanism.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
580 .
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
581 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
582 .B \-playlist <filename>
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
583 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
584 one-file-per-line format).
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
585 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
586 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
587 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
588 only to the elements of this playlist.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
589 .br
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
590 FIXME: This needs to be clarified and documented thoroughly.
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
12715
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
593 .B \-really-quiet (also see \-quiet)
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
594 Display even less output and status messages than with \-quiet.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
595 .
8234
ebf9a61bb88c -really-quiet documented
diego
parents: 8221
diff changeset
596 .TP
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
597 .B \-rtc-device <device>
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
598 Use the specified device for RTC timing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
599 .
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
600 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
601 .B \-shuffle
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
602 Play files in random order.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
603 .
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
604 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
605 .B \-skin <name> (GUI only)
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
606 Loads a skin from the directory given as parameter below the default skin
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
607 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
608 .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
609 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
610 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
611 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
612 .IPs "\-skin fittyfene"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
613 Tries /usr/\:local/\:share/\:mplayer/\:Skin/\:fittyfene
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
614 and afterwards ~/.mplayer/\:Skin/\:fittyfene.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
615 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
616 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
617 .
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
618 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
619 .B \-slave (also see \-input)
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
620 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
621 Instead of intercepting keyboard events, MPlayer will read commands from stdin.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
622 .br
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
623 .I NOTE:
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
624 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
625 for their description.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
626 .
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
627 .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
628 .B \-softsleep
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
629 Use high-quality software timers instead of the RTC.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
630 As precise as the RTC without requiring special privileges.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
631 Comes at the price of higher CPU consumption.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
632 .
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
633 .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
634 .B \-speed <0.01\-100>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
635 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
636 .
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
637 .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
638 .B \-sstep <sec>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
639 Display one frame every <sec> seconds.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
640 Useful for slideshows.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
641 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
642 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
643 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
644 .SH "DEMUXER/\:STREAM OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
645 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
646 .TP
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
647 .B \-a52drc <level>
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
648 Select the Dynamic Range Compression level for AC3 audio streams.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
649 <level> is a float value ranging from 0 to 1, where 0 means no compression
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
650 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
651 silent and vice versa).
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
652 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
653 compression information.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
654 .
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
655 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
656 .B \-aid <ID> (also see \-alang)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
657 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
658 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
659 MPlayer prints the available IDs when run in verbose (\-v) mode.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
660 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
661 (if present) with the chosen audio stream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
662 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
663 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
664 .B \-alang <two letter\ country\ code> (also see \-aid) (DVD only)
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
665 Selects the DVD audio language and tries to play audio streams whose
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
666 language matches the given code.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
667 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
668 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
669 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
670 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
671 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
672 .IPs "\-alang hu,en"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
673 Plays Hungarian and falls back on English if Hungarian is not available.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
674 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
675 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
676 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
677 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
678 .B \-audio-demuxer <number> (\-audiofile only)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
679 Force audio demuxer type for \-audiofile.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
680 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
681 \-audio-demuxer 17 forces MP3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
682 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
683 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
684 .B \-audiofile <filename>
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
685 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
686 movie.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
687 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
688 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
689 .B \-audiofile-cache <kBytes>
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
690 Enables caching for the stream used by \-audiofile, using the specified
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
691 amount of memory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
692 .
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
693 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
694 .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
695 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
696 able to send content in different bitrates).
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
697 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
698 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
699 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
700 .B \-cdrom-device <path\ to\ device>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
701 Specify the CD-ROM device (default: /dev/\:cdrom).
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
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
704 .B \-cache <kBytes>
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
705 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
706 file or URL.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
707 Especially useful on slow media.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
708 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
709 .TP
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
710 .B \-cache-min <percentage>
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
711 Playback will start when the cache fill threshold set with this option
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
712 is reached.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
713 .
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
714 .TP
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
715 .B \-cache-prefill <percentage> (not yet implemented)
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
716 When the cache is emptied MPlayer will pause and restart playback when
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
717 the cache prefill threshold set with this option is reached.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
718 .
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
719 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
720 .B \-cdda <option1:option2> (CDDA only)
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
721 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
722 .sp 1
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
723 Available options are:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
724 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
725 .IPs speed=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
726 Set CD spin speed.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
727 .IPs paranoia=<0\-2>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
728 Set paranoia level.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
729 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
730 0: disable checking
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
731 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
732 1: overlap checking only (default)
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
733 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
734 2: full data correction and verification
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
735 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
736 .IPs generic-dev=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
737 Use specified generic SCSI device.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
738 .IPs sector-size=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
739 Set atomic read size.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
740 .IPs overlap=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
741 Force minimum overlap search during verification to <value> sectors.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
742 .IPs toc-bias
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
743 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
744 addressed as LBA\ 0.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
745 Some Toshiba drives need this for getting track boundaries correct.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
746 .IPs toc-offset=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
747 Add <value> sectors to the values reported when addressing tracks.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
748 May be negative.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
749 .IPs (no)skip
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
750 (Never) accept imperfect data reconstruction.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
751 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
752 .
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
753 .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
754 .B \-channels <number>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
755 Change the number of playback channels (default: 2).
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
756 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
757 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
758 channel is repeated in both output channels).
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
759 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
760 results depend on the audio decoder (\-afm).
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
761 MPlayer asks the decoder to decode the audio into as many channels as
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
762 specified.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
763 Now it's up to the decoder to fulfill the requirement.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
764 If the decoder outputs more channels than requested, the exceeding channels
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
765 are truncated.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
766 This is usually only important when playing videos with AC3 audio (like DVDs).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
767 In that case liba52 does the decoding by default and correctly downmixes the
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
768 audio into the requested number of channels.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
769 .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
770 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
771 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
772 (OSS at least).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
773 .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
774 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
775 .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
776 .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
777 .RSs
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
778 .IPs 2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
779 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
780 .IPs 4
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
781 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
782 .IPs 6
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
783 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
784 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
785 .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
786 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
787 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
788 .B \-chapter <chapter\ ID>[\-<end\ chapter\ ID>] (DVD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
789 Specify which chapter to start playing at.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
790 Optionally specify which chapter to end playing at (default: 1).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
791 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
792 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
793 .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
794 Send cookies when making HTTP requests.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
795 .
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
796 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
797 .B \-cookies-file <filename> (network only)
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
798 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
799 and skip reading from default locations.
11603
fbef9326c2ed small fixes
diego
parents: 11600
diff changeset
800 The file is assumed to be in Netscape format.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
801 .
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
802 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
803 .B \-demuxer <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
804 Force demuxer type.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
805 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
806 \-demuxer 17 forces MP3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
807 .
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
808 .TP
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
809 .B \-dumpaudio (MPlayer only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
810 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
811 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
812 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
813 .B \-dumpfile <filename> (MPlayer only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
814 Specify which file MPlayer should dump to.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
815 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
816 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
817 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
818 .B \-dumpstream (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
819 Dumps the raw stream to ./stream.dump.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
820 Useful when ripping from DVD or network.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
821 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
822 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
823 .B \-dumpvideo (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
824 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
825 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
826 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
827 .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
828 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
829 the default ones:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
830 .sp 1
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
831 .PD 0
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
832 .RSs
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
833 .IPs card=<1\-4>
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
834 Specifies using card number 1\-4 (default: 1).
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
835 .IPs file=<filename>
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
836 Instructs MPlayer to read the channels list from <filename>.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
837 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl} (based on your card type)
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
838 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
839 .RE
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
840 .PD 1
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
841 .
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
842 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
843 .B \-dvd-device <path\ to\ device> (DVD only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
844 Specify the DVD device (default: /dev/\:dvd).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
845 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
846 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
847 .B \-dvdangle <angle\ ID> (DVD only)
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
848 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
849 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
850 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
851 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
852 .B \-forceidx
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
853 Force index rebuilding.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
854 Useful for files with broken index (A/\:V desync, etc).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
855 This will enable seeking in files where seeking was not possible.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
856 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
857 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
858 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
859 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
860 (i.e.\& not with stdin, pipe, etc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
861 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
862 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
863 .B \-fps <float value>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
864 Override video framerate.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
865 Useful if the original value is wrong or missing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
866 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
867 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
868 .B \-frames <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
869 Play/\:convert only first <number> frames, then quit.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
870 .
472
a25ba0fd865e commiting yesterday's changes that accidently lost ;(((
gabucino
parents: 454
diff changeset
871 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
872 .B \-hr-mp3-seek (MP3 only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
873 Hi-res MP3 seeking.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
874 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
875 to the very exact position to keep A/\:V sync.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
876 Can be slow especially when seeking backwards since it has to rewind
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
877 to the beginning to find an exact frame position.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
878 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
879 .TP
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
880 .B \-idx (also see \-forceidx)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
881 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
882 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
883 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
884 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
885 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
886 (i.e.\& not with stdin, pipe, etc).
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 \-ipv4-only-proxy (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
890 Skip the proxy for IPv6 addresses.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
891 It will still be used for IPv4 connections.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
892 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
893 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
894 .B \-loadidx <index file>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
895 The file from which to read the video index data saved by \-saveidx.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
896 This index will be used for seeking, overriding any index data
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
897 contained in the AVI itself.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
898 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
899 from a different AVI, but this is sure to cause unfavorable results.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
900 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
901 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
902 This option is obsolete now that MPlayer has OpenDML support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
903 .
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
904 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
905 .B \-mc <seconds/\:frame>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
906 maximum A-V sync correction per frame (in seconds)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
907 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
908 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
909 .B \-mf <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
910 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
911 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
912 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
913 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
914 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
915 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
916 .IPs w=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
917 output width (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
918 .IPs h=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
919 output height (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
920 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
921 output fps (default: 25)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
922 .IPs type=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
923 input file type (available: jpeg, png, tga, sgi)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
924 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
925 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
926 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
927 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
928 .B \-ni (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
929 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
930 of some bad AVI files).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
931 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
932 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
933 .B \-nobps (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
934 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
935 Helps with some AVI files with broken header.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
936 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
937 .TP
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
938 .B \-noextbased
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
939 Disables extension-based demuxer selection.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
940 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
941 (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
942 extension is used to select the demuxer.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
943 Always falls back on content-based demuxer selection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
944 .
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
945 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
946 .B \-passwd <password> (also see \-user) (network only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
947 Specify password for HTTP authentication.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
948 .
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
949 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
950 .B \-prefer-ipv4 (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
951 Use IPv4 on network connections.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
952 Falls back on IPv6 automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
953 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
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 \-prefer-ipv6 (IPv6 network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
956 Use IPv6 on network connections.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
957 Falls back on IPv4 automatically.
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
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
960 .B \-rawaudio <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
961 This option lets you play raw audio files.
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
962 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
963 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
964 .sp 1
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
965 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
966 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
967 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
968 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
969 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
970 Use raw audio demuxer.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
971 .IPs channels=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
972 number of channels
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
973 .IPs rate=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
974 rate in samples per second
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
975 .IPs samplesize=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
976 sample size in bytes
12282
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
977 .IPs bitrate=<value>
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
978 bitrate for rawaudio files
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
979 .IPs format=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
980 fourcc in hex
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
981 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
982 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
983 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
984 .TP
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
985 .B \-rawvideo <option1:option2:...>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
986 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
987 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
988 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
989 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
990 .PD 0
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
991 .RSs
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
992 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
993 Use raw video demuxer.
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
994 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
995 rate in frames per second (default: 25.0)
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
996 .IPs sqcif|qcif|cif|4cif|pal|ntsc
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
997 set standard image size
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
998 .IPs w=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
999 image width in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1000 .IPs h=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1001 image height in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1002 .IPs y420|yv12|yuy2|y8
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1003 set colorspace
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1004 .IPs format=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1005 colorspace (fourcc) in hex
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1006 .IPs size=<value>
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
1007 frame size in Bytes
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1008 .RE
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1009 .PD 1
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1010 .
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1011 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1012 .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
1013 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1014 packets be streamed over TCP (using the same TCP connection as RTSP).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1015 This option may be useful if you have a broken internet connection that does
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1016 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
1017 .
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
1018 .TP
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
1019 .B \-saveidx <filename>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1020 Force index rebuilding and dump the index to <filename>.
11293
e9f585aec12e -loadidx and -saveidx explanation extended.
diego
parents: 11286
diff changeset
1021 Currently this only works with AVI files.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1022 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1023 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1024 This option is obsolete now that MPlayer has OpenDML support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1025 .
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
1026 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1027 .B \-sb <byte\ position> (also see \-ss)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1028 Seek to byte position.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1029 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
1030 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1031 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1032 .B \-srate <Hz>
11906
47e9cd92d163 Fix description of -srate, as pointed out by Rich.
diego
parents: 11904
diff changeset
1033 Selects the given output sampling rate, resampling if necessary.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1034 MEncoder passes this value to LAME for resampling.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1035 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1036 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1037 .B \-ss <time> (also see \-sb)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1038 Seek to given time position.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1039 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1040 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1041 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1042 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1043 .IPs "\-ss 56"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1044 Seeks to 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1045 .IPs "\-ss 01:10:00"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1046 Seeks to 1\ hour 10\ min.
7288
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 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1050 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1051 .B \-tskeepbroken
11203
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1052 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
1053 Sometimes needed to play corrupted MPEG-TS files.
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1054 .
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1055 .TP
12994
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1056 .B \-tsprobe <byte\ position>
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1057 When playing an MPEG-TS stream, this option lets you specify how many
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1058 bytes in the stream you want MPlayer to search for the desired
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1059 audio and video pids.
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1060 .
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1061 .TP
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1062 .B \-tsprog <1\-65534>
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1063 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
1064 program (if present) you want to play.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1065 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
1066 .
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1067 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1068 .B \-tv <option1:option2:...> (TV only)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1069 This option tunes various properties of the TV capture module.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1070 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
1071 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
1072 as a movie URL.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1073 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1074 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1075 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1076 .IPs noaudio
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1077 no sound
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1078 .IPs driver=<value>
10537
31f12f99118b v4l2 support
henry
parents: 10524
diff changeset
1079 available: dummy, v4l, v4l2, bsdbt848
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1080 .IPs device=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1081 Specify TV device (default: /dev/\:video0).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1082 .IPs input=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1083 Specify input (default: 0 (TV), see console output for available inputs).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1084 .IPs freq=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1085 Specify the frequency to set the tuner to (e.g.\& 511.250).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1086 Not compatible with the channels parameter.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1087 .IPs outfmt=<value>
11365
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1088 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
1089 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
1090 arbitrary format given as hex value.
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1091 Try outfmt=help for a list of all available formats.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1092 .IPs width=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1093 output window width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1094 .IPs height=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1095 output window height
8879
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1096 .IPs fps=<value>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1097 framerate at which to capture video (frames per second)
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1098 .IPs buffersize=<value>
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
1099 maximum size of the capture buffer in megabytes (default: dynamical)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1100 .IPs norm=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1101 available: PAL, SECAM, NTSC.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1102 For v4l2 use the normid option below.
13016
61d0fd8411cc Missing quotes added
wight
parents: 13014
diff changeset
1103 .IPs "normid=<value> (v4l2 only)"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1104 See console output for a list of available TV norms.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1105 .IPs channel=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1106 Set tuner to <value> channel.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1107 .IPs chanlist=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1108 available: europe-east, europe-west, us-bcast, us-cable, etc
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
1109 .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
1110 Set names for channels.
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1111 Use _ for spaces in names (or play with quoting ;-).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1112 The channel names will then be written using OSD, and the slave commands
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1113 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
1114 a remote control (see LIRC).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1115 Not compatible with the frequency parameter.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1116 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1117 .I NOTE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1118 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
1119 beginning with 1.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1120 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1121 .I EXAMPLE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1122 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
1123 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1124 Set the image equalizer on the card.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1125 .IPs audiorate=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1126 Set audio capture bitrate.
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1127 .IPs forceaudio
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1128 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
1129 .IPs alsa\
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1130 Capture from ALSA.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1131 .IPs amode=<0\-3>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1132 Choose an audio mode:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1133 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1134 0: mono
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1135 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1136 1: stereo
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1137 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1138 2: language 1
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1139 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1140 3: language 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1141 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1142 .IPs forcechan=<1\-2>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1143 By default, the count of recorded audio channels is determined automatically
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1144 by querying the audio mode from the TV card.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1145 This option allows forcing stereo/\:mono recording regardless of the amode
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1146 option and the values returned by v4l.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1147 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
1148 current audio mode.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1149 .IPs adevice=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1150 Set an audio device.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1151 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1152 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
1153 .IPs audioid=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1154 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
1155 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1156 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1157 These options set parameters of the mixer on the video capture card.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1158 They will have no effect, if your card does not have one.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1159 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
1160 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
1161 .IPs immediatemode=<bool>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1162 A value of 0 means capture and buffer audio and video together
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1163 (default for MEncoder).
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1164 A value of 1 (default for MPlayer) means to do video capture only and let the
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1165 audio go through a loopback cable from the TV card to the soundcard.
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1166 .IPs mjpeg
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1167 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
1168 When using this option, you do not need to specify the width and height
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1169 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
1170 from the decimation value (see below).
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1171 .IPs decimation=<1,2,4>
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1172 choose the size of the picture that will be compressed by hardware
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1173 MJPEG compression:
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1174 .RSss
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1175 1: full size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1176 704x576 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1177 704x480 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1178 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1179 2: medium size
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1180 352x288 PAL
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1181 352x240 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1182 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1183 4: small size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1184 176x144 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1185 176x120 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1186 .REss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1187 .IPs quality=<0\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1188 Choose the quality of the JPEG compression
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1189 (< 60 recommended for full size).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1190 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1191 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1192 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1193 .B \-user <username> (also see \-passwd) (network only)
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1194 Specify username for HTTP authentication.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1195 .
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
1196 .TP
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1197 .B \-user-agent <string>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1198 Use <string> as user agent for HTTP streaming.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1199 .
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1200 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1201 .B \-vid <ID>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1202 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1203 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
1204 (if present) with the chosen video stream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1205 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1206 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1207 .B \-vivo <sub-options> (DEBUG CODE)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1208 Force audio parameters for the VIVO demuxer (for debugging purposes).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1209 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1210 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1211 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1212 .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
1213 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1214 Also see \-vf expand.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1215 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1216 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1217 .B \-dumpjacosub (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1218 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1219 JACOsub subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1220 Creates a dumpsub.js file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1221 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1222 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1223 .B \-dumpmicrodvdsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1224 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
1225 MicroDVD subtitle format.
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1226 Creates a dumpsub.sub file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1227 .
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1228 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1229 .B \-dumpmpsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1230 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
1231 subtitle format, MPsub.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1232 Creates a dump.mpsub file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1233 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1234 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1235 .B \-dumpsami (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1236 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1237 SAMI subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1238 Creates a dumpsub.smi file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1239 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1240 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1241 .B \-dumpsrtsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1242 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
1243 SubViewer (SRT) subtitle format.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1244 Creates a dumpsub.srt file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1245 .
6378
64a828f1872b added -dumpsrtsub
gabucino
parents: 6351
diff changeset
1246 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1247 .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
1248 Dumps the subtitle substream from VOB streams.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1249 Also see the \-dump*sub and \-vobsubout* options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1250 .
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
1251 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1252 .B \-ffactor <number> (OSD only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1253 Resample the font alphamap.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1254 Can be:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1255 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1256 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1257 .IPs 0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1258 plain white fonts
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1259 .IPs 0.75
8762
75d22ee5f975 Per-file configuration, typos, rewordings, consistency and a 10l .In.
diego
parents: 8745
diff changeset
1260 very narrow black outline (default)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1261 .IPs 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1262 narrow black outline
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1263 .IPs 10
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1264 bold black outline
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1265 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1266 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1267 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1268 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1269 .B \-flip-hebrew (FriBiDi only)
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1270 Turns on flipping subtitles using FriBiDi.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1271 .
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1272 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1273 .B \-font <path\ to\ font.desc\ file> (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1274 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
1275 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1276 ~/.mplayer/\:subfont.ttf).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1277 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1278 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1279 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
1280 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
1281 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1282 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1283 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1284 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1285 \-font ~/\:.mplayer/\:arial-14/\:font.desc
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1286 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1287 \-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
1288 .br
90953d955165 Fontconfig support based on patch by Arwed von Merkatz <v.merkatz@gmx.net>, but slightly reworked
alex
parents: 11572
diff changeset
1289 \-font 'Bitstream Vera Sans'
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1290 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1291 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1292 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1293 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1294 .B \-fontconfig (fontconfig only)
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1295 Enables the usage of fontconfig managed fonts.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1296 .
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1297 .TP
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1298 .B \-forcedsubsonly
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1299 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
1300 \-slang.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1301 .
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1302 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1303 .B \-fribidi-charset <charset\ name> (FriBiDi only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1304 Specifies the character set that will be passed to FriBiDi when
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1305 decoding non-UTF-8 subtitles (default: ISO8859-8).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1306 .
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1307 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1308 .B \-ifo <VOBsub\ ifo\ file>
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1309 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
1310 subtitles.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1311 .
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1312 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1313 .B \-noautosub
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1314 Turns off automatic subtitle file loading.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1315 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1316 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1317 .B \-osdlevel <0\-3> (MPlayer only)
8810
bdcde34deb14 10l, osdlevel, fixes
jonas
parents: 8806
diff changeset
1318 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
1319 .PD 0
8811
jonas
parents: 8810
diff changeset
1320 .RSs
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1321 .IPs 0
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1322 subtitles only
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1323 .IPs 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1324 volume + seek (default)
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1325 .IPs 2
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1326 volume + seek + timer + percentage
9162
jonas
parents: 9139
diff changeset
1327 .IPs 3
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1328 volume + seek + timer + percentage + total time
8811
jonas
parents: 8810
diff changeset
1329 .RE
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1330 .PD 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1331 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1332 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1333 .B \-overlapsub
10393
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1334 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
1335 still visible (default is to enable the support only for specific
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1336 formats).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1337 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1338 .TP
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1339 .B \-sid <ID> (also see \-slang option)
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1340 Display DVD subtitles in the language specified by <ID> (0\-31).
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1341 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
1342 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1343 .TP
13160
7dbbfba0a722 better -slang description inspired by a patch from Guillaume Poirier
diego
parents: 13159
diff changeset
1344 .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
1345 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
1346 Languages must be given as two letter country codes.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1347 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
1348 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1349 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1350 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1351 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1352 .IPs "\-slang hu,en"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1353 Selects Hungarian and falls back on English if Hungarian is not available.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1354 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1355 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1356 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1357 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1358 .B \-spuaa <mode> (OSD only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1359 Antialiasing/\:scaling mode for DVD/\:VOBsub.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1360 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
1361 when original and scaled frame size already match.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1362 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1363 Available modes are:
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1364 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1365 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1366 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1367 none (fastest, very ugly)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1368 .IPs 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1369 approximate (broken?)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1370 .IPs 2
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1371 full (slow)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1372 .IPs 3
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1373 bilinear (default, fast and not too bad)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1374 .IPs 4
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1375 uses swscaler gaussian blur (looks very good)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1376 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1377 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1378 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1379 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1380 .B \-spualign <-1\-2> (OSD only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1381 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1382 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1383 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1384 .IPs -1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1385 original position
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1386 .IPs 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1387 align at top (original/\:default behavior)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1388 .IPs 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1389 align at center
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1390 .IPs 2
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1391 align at bottom
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1392 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1393 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1394 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1395 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1396 .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
1397 Variance parameter of gaussian used by \-spuaa 4.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1398 Higher means more blur (default: 1.0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1399 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1400 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1401 .B \-sub <subtitlefile1,subtitlefile2,...>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1402 Use/\:display these subtitle files.
13134
2c3a4098f40c Cycle through the available subtitles with 'b'.
diego
parents: 13107
diff changeset
1403 Only one file can be displayed at the same time.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1404 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1405 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1406 .B \-sub-bg-alpha <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1407 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
1408 Big values mean more transparency.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1409 0 means completely transparent.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1410 .
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1411 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1412 .B \-sub-bg-color <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1413 Specify the color value for subtitles and OSD backgrounds.
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1414 Currently subtitles are grayscale so this value is equivalente to the
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1415 intensity of the color.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1416 255 means white and 0 black.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1417 .
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1418 .TP
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1419 .B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1420 Force subtitle demuxer type for \-subfile.
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1421 Give the demuxer ID as defined in subreader.h.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1422 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1423 .TP
11448
gabucino
parents: 11446
diff changeset
1424 .B \-sub-fuzziness <mode>
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1425 Adjust matching fuzziness when searching for subtitles:
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1426 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1427 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1428 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1429 exact match
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1430 .IPs 1
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1431 Load all subs containing movie name.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1432 .IPs 2
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1433 Load all subs in the current directory.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1434 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1435 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1436 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1437 .TP
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1438 .B \-sub-no-text-pp
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1439 Disables any kind of text post processing done after loading the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1440 Used for debug purposes.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1441 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1442 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1443 .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
1444 Specify how subtitles should be aligned with \-subpos.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1445 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1446 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1447 .IPs 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1448 align at top (original/\:default behavior)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1449 .IPs 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1450 align at center
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1451 .IPs 2
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1452 align at bottom
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1453 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1454 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1455 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1456 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1457 .B \-subcc \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1458 Display DVD Closed Caption (CC) subtitles.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1459 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
1460 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
1461 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
1462 .
7049
0caeda287ff9 -subcc option documented, patch by Robert R. Wal <rrw at hell pl>.
diego
parents: 7045
diff changeset
1463 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1464 .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
1465 If your system supports iconv(3), you can use this option to
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1466 specify the subtitle codepage.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1467 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1468 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1469 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1470 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1471 \-subcp latin2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1472 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1473 \-subcp cp1250
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1474 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1475 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1476 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1477 .TP
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1478 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1479 You can specify your language using a two letter language code to
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1480 make ENCA detect the codepage automatically.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1481 If unsure, enter anything and watch mplayer \-v output for available
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1482 languages.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1483 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
1484 .sp 1
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1485 .I EXAMPLE:
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1486 .PD 0
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1487 .RSs
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1488 .IPs "\-subcp enca:cs:latin2"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1489 Guess the encoding, assuming the subtitles are Czech, fall back on
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1490 latin 2, if the detection fails.
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1491 .IPs "\-subcp enca:pl:cp1250"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1492 Guess the encoding for Polish, fall back on cp1250.
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1493 .RE
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1494 .PD 1
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1495 .
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1496 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1497 .B \-subdelay <sec>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1498 Delays subtitles by <sec> seconds.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1499 Can be negative.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1500 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1501 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1502 .B \-subfile <filename> (BETA CODE)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1503 Currently useless.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1504 Same as \-audiofile, but for subtitle streams (OggDS?).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1505 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1506 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1507 .B \-subfont-autoscale <0\-3> (FreeType only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1508 Sets the autoscale mode.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1509 .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
1510 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1511 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
1512 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1513 The mode can be:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1514 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1515 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1516 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1517 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1518 no autoscale
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1519 .IPs 1
8265
rfelker
parents: 8248
diff changeset
1520 proportional to movie height
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1521 .IPs 2
8265
rfelker
parents: 8248
diff changeset
1522 proportional to movie width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1523 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1524 proportional to movie diagonal (default)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1525 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1526 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1527 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1528 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1529 .B \-subfont-blur <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1530 Sets the font blur radius (default: 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1531 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1532 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1533 .B \-subfont-encoding <value> (FreeType only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1534 Sets the font encoding.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1535 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
1536 unicode will be used (default: unicode).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1537 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1538 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1539 .B \-subfont-osd-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1540 Sets the autoscale coefficient of the OSD elements (default: 6).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1541 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1542 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1543 .B \-subfont-outline <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1544 Sets the font outline thickness (default: 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1545 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1546 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1547 .B \-subfont-text-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1548 Sets the subtitle text autoscale coefficient as percentage of the
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1549 screen size (default: 5).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1550 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1551 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1552 .B \-subfps <rate>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1553 Specify the framerate of the subtitle file (default: movie fps).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1554 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1555 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1556 Only for frame-based subtitle files, i.e.\& not MicroDVD format.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1557 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1558 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1559 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1560 Specify the position of subtitles on the screen.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1561 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
1562 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1563 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1564 .B \-subwidth <10\-100> (OSD only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1565 Specify the maximum width of subtitles on the screen.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1566 Useful for TV-out.
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1567 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
1568 .
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1569 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1570 .B \-unicode
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1571 Tells MPlayer to handle the subtitle file as unicode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1572 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1573 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1574 .B \-utf8 \ \
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1575 Tells MPlayer to handle the subtitle file as UTF-8.
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
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1578 .B \-vobsub <VOBsub\ file\ without\ extension>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1579 Specify a VOBsub file to use for subtitles.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1580 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
1581 the '.idx', '.ifo' or '.sub'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1582 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1583 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1584 .B \-vobsubid <0\-31>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1585 Specify the VOBsub subtitle ID.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1586 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1587 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1588 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1589 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1590 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1591 .TP
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
1592 .B \-abs <value> (\-ao oss only) (OBSOLETE)
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1593 Override audio driver/\:card buffer size detection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1594 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1595 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1596 .B \-aofile <filename>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1597 Override the default filename employed by \-ao pcm.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1598 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1599 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
1600 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1601 Specify audio plugin(s) and their options
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1602 (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
1603 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1604 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1605 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1606 .IPs list=[plugins]
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1607 comma separated list of plugins (resample, surround, format, volume,
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1608 extrastereo, volnorm, delay)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1609 .IPs delay=<sec>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1610 example plugin, do not use (delay plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1611 .IPs format=<format>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1612 output format (format plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1613 .IPs fout=<Hz>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1614 output frequency (resample plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1615 .IPs volume=<0\-255>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1616 volume (volume plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1617 .IPs mul=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1618 stereo coefficient (default: 2.5) (extrastereo plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1619 .IPs softclip
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1620 compressor / 'soft-clipping' capabilities (volume plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1621 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1622 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1623 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1624 .B \-delay <sec>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1625 Audio delay in seconds (positive or negative float value).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1626 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1627 .TP
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1628 .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
1629 Select the format used for output from the filter layer (according to the
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1630 defines in libao2/\:afmt.h):
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1631 .PD 0
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1632 .RSs
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1633 .IPs 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1634 Mu-Law
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1635 .IPs 2
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1636 A-Law
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1637 .IPs 4
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1638 Ima-ADPCM
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1639 .IPs 8
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1640 unsigned 8-bit
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1641 .IPs 16
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1642 signed 16-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
1643 .IPs 32
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1644 signed 16-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
1645 .IPs 64
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1646 signed 8-bit
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1647 .IPs 128
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1648 unsigned 16-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
1649 .IPs 256
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1650 unsigned 16-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
1651 .IPs 512
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1652 MPEG (2) Audio
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1653 .IPs 1024
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1654 AC3
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1655 .IPs 4096
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1656 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
1657 .IPs 8192
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1658 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
1659 .RE
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1660 .PD 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1661 .
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1662 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1663 .B \-mixer <device>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1664 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
1665 For ALSA this is the mixer name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1666 .
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1667 .TP
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1668 .B \-mixer-channel <mixer line> (\-ao oss and \-ao alsa only)
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1669 This option will tell MPlayer to use a different channel for controlling
11840
acef84b653a9 small fixes
diego
parents: 11837
diff changeset
1670 volume than the default PCM.
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1671 Options for OSS include
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1672 .B vol, pcm, line.
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1673 For a complete list of options look for SOUND_DEVICE_NAMES in
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1674 /usr/\:include/\:linux/\:soundcard.h.
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1675 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
1676 .B Master, Line, PCM.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1677 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1678 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1679 .B \-nowaveheader (\-ao pcm only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1680 Don't include wave header.
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1681 Used for raw PCM.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1682 .
13098
907fe1fdfc6c Make the stepsize of volume changes, changeable by a commandline paarameter
attila
parents: 13096
diff changeset
1683 .TP
907fe1fdfc6c Make the stepsize of volume changes, changeable by a commandline paarameter
attila
parents: 13096
diff changeset
1684 .B \-volstep <0\-100>
13104
b818ad985ce9 default style
wight
parents: 13098
diff changeset
1685 Set the step size of mixer volume changes in percent of the whole range
b818ad985ce9 default style
wight
parents: 13098
diff changeset
1686 (default: 3).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1687 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1688 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1689 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1690 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
1691 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
1692 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1693 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1694 .TP
12505
a0b82f1dda7d xvmc and *vidix suboptions documented, better ao/vo suboption syntax
diego
parents: 12479
diff changeset
1695 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1696 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
1697 .PP
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1698 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
1699 contained in the list.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1700 Suboptions are optional and can mostly be omitted.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1701 .br
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1702 .I NOTE:
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
1703 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
1704 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1705 .I EXAMPLE:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1706 .PD 0
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1707 .RSs
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1708 .IPs "\-ao alsa,oss,"
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1709 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
1710 .IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1711 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
1712 .RE
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1713 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1714 .sp 1
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1715 FIXME: Document suboptions for sdl, arts, esd, jack, nas, macosx, sgi, sun,
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
1716 dxr2, mpegpes, null, pcm, plugin.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1717 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1718 Available audio output drivers are:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1719 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1720 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1721 .B alsa\ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1722 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
1723 .PD 0
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1724 .RSs
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1725 .IPs mmap\ \ \
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1726 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
1727 .IPs noblock
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1728 Sets noblock-mode.
12807
6494aa5947ee ao_alsa now uses the device= suboption syntax instead of hw= or hw:
reimar
parents: 12778
diff changeset
1729 .IPs device=<device>
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1730 Sets the device name.
12919
aba44b58dea7 Use = instead if # in ALSA device name, as # irritates our config-parser.
reimar
parents: 12867
diff changeset
1731 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1732 .RE
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1733 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1734 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1735 .TP
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1736 .B alsa1x (OBSOLETE)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1737 ALSA 1.x audio output driver.
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1738 Obsoleted by the general alsa audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1739 .
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1740 .TP
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1741 .B alsa9 (OBSOLETE)
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1742 ALSA 0.9 audio output driver.
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1743 Obsoleted by the general alsa audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1744 .
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1745 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1746 .B alsa5\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1747 ALSA 0.5 audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1748 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1749 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1750 .B oss\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1751 OSS audio output driver
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1752 .PD 0
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1753 .RSs
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1754 .IPs dsp-device
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1755 Sets the audio-output device (default: /dev/\:dsp).
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1756 .RE
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1757 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1758 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1759 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1760 .B sdl\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1761 Highly platform independent SDL (Simple Directmedia Layer) library
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1762 audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1763 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1764 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1765 .B arts\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1766 Audio output through the Arts daemon.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1767 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1768 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1769 .B esd\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1770 Audio output through the ESD daemon.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1771 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1772 .TP
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1773 .B jack\ \ \ \
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1774 Audio output through JACK (Jack Audio Connection Kit).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1775 .
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1776 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1777 .B nas\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1778 Audio output through NAS.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1779 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1780 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1781 .B macosx (Mac OS X only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1782 Native Mac OS X audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1783 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1784 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1785 .B sgi (SGI only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1786 Native SGI audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1787 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1788 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1789 .B sun (Sun only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1790 Native Sun audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1791 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1792 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1793 .B win32 (Windows only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1794 Native Windows waveout audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1795 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1796 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1797 .B dxr2 (also see \-dxr2) (DXR2 only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1798 Creative DXR2 specific output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1799 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1800 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1801 .B mpegpes (DVB only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1802 DVB specific output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1803 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1804 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1805 .B null\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1806 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
1807 Use \-nosound for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1808 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1809 .TP
13076
2e15bacb1897 missing \
wight
parents: 13068
diff changeset
1810 .B pcm (also see \-aofile)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1811 Raw PCM/\:wave file writer audio output.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1812 Writes the sound to ./audiodump.wav.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1813 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1814 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1815 .B plugin\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1816 Plugin audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1817 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1818 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1819 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1820 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1821 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1822 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1823 .B \-aa* (\-vo aa only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1824 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
1825 .I mplayer \-aahelp
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1826 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1827 .TP
12389
0b1053e9d8da -adapter is not directx specific anymore.
diego
parents: 12388
diff changeset
1828 .B \-adapter <value>
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1829 Set the graphics card that will receive the image.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1830 Needs the \-vm option to work.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1831 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
1832 Works currently only with \-vo directx.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1833 .
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1834 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1835 .B \-bpp <depth>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1836 Override the autodetected color depth.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1837 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
1838 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1839 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1840 .B \-brightness <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1841 Adjust the brightness of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1842 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1843 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1844 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1845 .B \-contrast <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1846 Adjust the contrast of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1847 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1848 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1849 .TP
12013
d0a1e865c1af -vo directfb options by Jiri Svoboda
diego
parents: 11993
diff changeset
1850 .B \-dfbopts <value> (\-vo directfb only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1851 Specify a parameter list for the directfb video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1852 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1853 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1854 .B \-display <name> (X11 only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1855 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
1856 on.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1857 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1858 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1859 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1860 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1861 \-display xtest.localdomain:0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1862 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1863 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1864 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1865 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1866 .B \-double
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1867 Enables double buffering.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1868 Fixes flicker by storing two frames in memory, and displaying one while
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1869 decoding another.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1870 Can affect OSD negatively, but often it removes OSD flickering.
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1871 Needs twice the memory of a single buffer, so it won't work on cards with
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1872 very little video memory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1873 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1874 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1875 .B \-dr \ \ \
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1876 Turns on direct rendering (not supported by all codecs and video outputs)
13040
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1877 .br
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1878 .I WARNING:
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1879 May cause OSD/\:SUB corruption!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1880 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1881 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1882 .B \-dxr2 <option1:option2:...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1883 This option is used to control the dxr2 video output driver.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1884 .RSs
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1885 .IPs ar-mode=<value>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1886 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
1887 .IPs iec958-encoded
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1888 Set iec958 output mode to encoded.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1889 .IPs iec958-decoded
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1890 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
1891 .IPs macrovision=<value>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1892 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
1893 3 = agc 4 colorstripe)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1894 .IPs mute\
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1895 mute sound output
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1896 .IPs unmute
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1897 unmute sound output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1898 .IPs ucode=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1899 path to the microcode
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1900 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1901 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1902 .sp 1
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1903 .I TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1904 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1905 .RSs
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1906 .IPs 75ire
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1907 enable 7.5 IRE output mode
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1908 .IPs no75ire
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1909 disable 7.5 IRE output mode (default)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1910 .IPs bw\ \ \
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1911 b/\:w TV output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1912 .IPs color
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1913 color TV output (default)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1914 .IPs interlaced
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1915 interlaced TV output (default)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1916 .IPs nointerlaced
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1917 disable interlaced TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1918 .IPs norm=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1919 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
1920 .IPs square-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1921 set pixel mode to square
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1922 .IPs ccir601-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1923 set pixel mode to ccir601
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1924 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1925 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1926 .sp 1
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1927 .I overlay
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1928 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1929 .RSs
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1930 .IPs cr-left=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1931 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
1932 .IPs cr-right=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1933 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
1934 .IPs cr-top=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1935 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
1936 .IPs cr-bottom=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1937 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
1938 .IPs ck-[r|g|b]=<0\-255>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1939 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
1940 .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
1941 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
1942 .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
1943 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
1944 .IPs ignore-cache
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1945 Ignore cached overlay settings.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1946 .IPs update-cache
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1947 Update cached overlay settings.
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1948 .IPs ol-osd
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1949 Enable overlay onscreen display.
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1950 .IPs nool-osd
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1951 Disable overlay onscreen display (default).
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1952 .IPs ol[h|w|x|y]-cor=<-20\-20>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1953 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
1954 match the window perfectly (default: 0).
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1955 .IPs overlay
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1956 Activate overlay (default).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1957 .IPs nooverlay
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1958 Activate TVout.
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1959 .IPs overlay-ratio=<1\-2500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1960 Tune the overlay (default: 1000).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1961 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1962 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1963 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1964 .B \-fb <device> (\-vo fbdev or directfb only) (OBSOLETE)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1965 Specifies the framebuffer device to use (default: /dev/\:fb0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1966 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1967 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1968 .B \-fbmode <modename> (\-vo fbdev only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1969 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
1970 /etc/\:fb.modes.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1971 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1972 .I NOTE:
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1973 VESA framebuffer doesn't support mode changing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1974 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1975 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1976 .B \-fbmodeconfig <filename> (\-vo fbdev only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1977 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1978 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1979 .TP
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
1980 .B \-forcexv (\-vo sdl only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1981 Force using XVideo through the sdl video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1982 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1983 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1984 .B \-fs (also see \-zoom)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1985 Fullscreen playback (centers movie, and paints black bands around it).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1986 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1987 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1988 .TP
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1989 .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
1990 Try this option if you still experience fullscreen problems.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1991 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1992 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1993 .B \-fstype <type1,type2,...> (X11 only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1994 Specify a priority list of fullscreen modes to be used.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1995 You can negate the modes by prefixing them with '\-'.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1996 If you experience problems like the fullscreen window being covered
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1997 by other windows try using a different order.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1998 .br
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1999 .I NOTE:
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2000 See \-fstype help for a full list of available modes.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2001 .sp 1
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2002 The available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2003 .sp 1
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2004 .PD 0
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
2005 .RSs
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2006 .IPs above
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2007 Use the _NETWM_STATE_ABOVE hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2008 .IPs below
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2009 Use the _NETWM_STATE_BELOW hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2010 .IPs fullscreen
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2011 Use the _NETWM_STATE_FULLSCREEN hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2012 .IPs layer
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2013 Use the _WIN_LAYER hint with the default layer.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2014 .IPs layer=<0..15>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2015 Use the _WIN_LAYER hint with the given layer number.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2016 .IPs netwm
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2017 Force NETWM style.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2018 .IPs none\
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2019 Do not set fullscreen window layer.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2020 .IPs stays_on_top
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2021 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2022 .REss
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2023 .sp 1
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2024 .RS
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2025 .I EXAMPLE:
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2026 .RE
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2027 .PD 0
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2028 .RSs
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2029 .IPs layer,stays_on_top,above,fullscreen
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2030 Default order, will be used as a fallback if incorrect or
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2031 unsupported modes are specified.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2032 .IPs \-fullscreen
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2033 Fixes fullscreen switching on OpenBox 1.x.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2034 .RE
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2035 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2036 .
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
2037 .TP
8745
93f78fb709e6 Added support for X style -geometry options (adapted from Henk's patch)
mark
parents: 8708
diff changeset
2038 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2039 Adjust where the output is on the screen initially.
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2040 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
2041 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
2042 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
2043 screen size in that direction.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2044 It also supports the standard X11 \-geometry option format.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2045 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2046 .I NOTE:
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2047 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2048 directx and tdfxfb video output drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2049 .sp 1
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2050 .I EXAMPLE:
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2051 .PD 0
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2052 .RSs
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2053 .IPs 50:40
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2054 Places the window at x=50, y=40.
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2055 .IPs 50%:50%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2056 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
2057 .IPs 100%\
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2058 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
2059 .IPs 100%:100%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2060 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
2061 .RE
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2062 .PD 1
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2063 .
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2064 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2065 .B \-guiwid <window\ ID> (also see \-wid) (GUI only)
9334
f6007efc714f spelling
diego
parents: 9314
diff changeset
2066 This tells the GUI to also use an X11 window and stick itself to the bottom
f6007efc714f spelling
diego
parents: 9314
diff changeset
2067 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
2068 MPlayer plugin for instance).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2069 .
9314
f38fe55d0e05 this patch adds the option -guiwid to gmplayer. I think its a more clean
arpi
parents: 9309
diff changeset
2070 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2071 .B \-hue <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2072 Adjust the hue of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2073 You can get a colored negative of the image with this option.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2074 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2075 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2076 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2077 .B \-monitor-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2078 Specify the dotclock or pixelclock range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2079 .
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2080 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2081 .B \-monitor-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2082 Specify the horizontal frequency range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2083 .
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2084 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2085 .B \-monitor-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2086 Specify the vertical frequency range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2087 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2088 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2089 .B \-monitoraspect <ratio> (also see \-aspect)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2090 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
2091 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
2092 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2093 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2094 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2095 \-monitoraspect 4:3 or 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2096 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2097 \-monitoraspect 16:9 or 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2098 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2099 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2100 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2101 .TP
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2102 .B \-nograbpointer
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2103 Do not grab the mouse pointer after a video mode change (\-vm).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2104 Useful for multihead setups.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2105 .
8692
604f0cde816c X11 window aspect patch by Arnaud Boulan <boulan@iie.cnam.fr>
attila
parents: 8685
diff changeset
2106 .TP
12388
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
2107 .B \-nokeepaspect
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2108 Do not keep window aspect ratio when resizing windows.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2109 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2110 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
2111 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2112 .TP
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2113 .B \-noxv (\-vo sdl only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2114 Disables using XVideo through the sdl video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2115 .
10991
e65b09eb0a2a sdl only -noxv
alex
parents: 10974
diff changeset
2116 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2117 .B \-ontop\
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2118 Makes the player window stay on top of other windows.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2119 Supported by video output drivers which use X11, except SDL,
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2120 as well as directx and gl2.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2121 .
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
2122 .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
2123 .B \-panscan <0.0\-1.0>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2124 Enables pan and scan functionality (cropping the sides of e.g.\& a 16:9
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2125 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
2126 The range controls how much of the image is cropped.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2127 Only works with the xv, xmga, mga and xvidix video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2128 .
6330
68a3003b57ce panscan added
gabucino
parents: 6326
diff changeset
2129 .TP
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2130 .B \-refreshrate <Hz>
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2131 Set the monitor refreshrate in Hz.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2132 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
2133 .
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2134 .TP
13005
8d37cc41a272 -rootwin is no longer X11 only.
diego
parents: 13002
diff changeset
2135 .B \-rootwin
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2136 Play movie in the root window (desktop background).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2137 Desktop background images may cover the movie window, though.
13090
0c37bcfc5ef0 added -rootwin support to vo_directx
joey
parents: 13088
diff changeset
2138 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
2139 .
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2140 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2141 .B \-saturation <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2142 Adjust the saturation of the video signal (default: 0).
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2143 You can get grayscale output with this option.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2144 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2145 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2146 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2147 .B \-screenh <pixels>
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2148 Specify the vertical screen resolution for video output drivers which
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2149 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
2150 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2151 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2152 .B \-screenw <pixels>
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2153 Specify the horizontal screen resolution for video output drivers which
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2154 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
2155 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2156 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2157 .B \-stop-xscreensaver (X11 only)
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2158 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
2159 .
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2160 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2161 .B \-vm \ \ \
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2162 Try to change to a different video mode.
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2163 Supported by the dga, x11, xv, sdl and directx video output drivers.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2164 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
2165 \-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
2166 the new display mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2167 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2168 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2169 .B \-vsync \ \
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2170 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
2171 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2172 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2173 .B \-wid <window\ ID> (also see \-guiwid) (X11 only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2174 This tells MPlayer to attach to an existing X11 window.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2175 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
2176 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2177 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2178 .B \-xineramascreen <0\-...>
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2179 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2180 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
2181 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2182 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2183 .B \-z <0\-9> (\-vo png only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2184 Specifies the compression level of the png video output driver.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2185 0 is no compression, 9 is the maximum compression.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2186 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2187 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2188 .B \-zrbw (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2189 Display in black and white.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2190 For optimal performance, this can be combined with '\-lavdopts gray'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2191 .
7192
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2192 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2193 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2194 Select a part of the input image to display, multiple occurences
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2195 of this option switch on cinerama mode.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2196 In cinerama mode the movie is distributed over more than one TV
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2197 (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
2198 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
2199 card should at least have a \-zrdev in addition to the \-zrcrop.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2200 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
2201 documentation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2202 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2203 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2204 .B \-zrdev <device> (\-vo zr only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2205 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
2206 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
2207 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2208 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2209 .B \-zrfd (\-vo zr only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2210 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2211 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
2212 Use this option to force decimation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2213 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2214 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2215 .B \-zrhdec <1,2,4> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2216 Horizontal decimation: Ask the driver to send only every 2nd or 4th
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2217 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
2218 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
2219 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2220 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2221 .B \-zrhelp (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2222 Display a list of all \-zr* options, their default values and a
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2223 cinerama mode example.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2224 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2225 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2226 .B \-zrnorm <norm> (\-vo zr only)
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2227 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
2228 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2229 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2230 .B \-zrquality <1\-20> (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2231 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
2232 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2233 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2234 .B \-zrvdec <1,2,4> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2235 Vertical decimation: Ask the driver to send only every 2nd or 4th
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2236 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
2237 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
2238 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2239 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2240 .B \-zrxdoff <x display offset> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2241 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
2242 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
2243 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2244 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2245 .B \-zrydoff <y display offset> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2246 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
2247 offset from the upper-left corner of the TV screen (default: centered).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2248 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2249 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2250 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2251 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2252 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
2253 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2254 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2255 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2256 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2257 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
2258 .PP
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2259 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
2260 contained in the list.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2261 Suboptions are optional and can mostly be omitted.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2262 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2263 .I NOTE:
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2264 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
2265 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2266 .I EXAMPLE:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2267 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2268 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2269 .IPs "\-vo xmga,xv,"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2270 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
2271 .IPs "\-vo directx:noaccel"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2272 Uses the DirectX driver with acceleration features turned off.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2273 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2274 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2275 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2276 FIXME: Document suboptions for x11, xover, dga, sdl, vidix, xvidix, fbdev,
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2277 fbdev2, vesa, null, aa, bl, ggi, mga, xmga, syncfb, 3dfx, tdfx_vid,
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2278 tdfxfb, dxr2, dxr3, mpegpes, zr, zr2, yuv4mpeg, gif89a, jpeg, pgm, png, tga.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2279 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2280 Available video output drivers are:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2281 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2282 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2283 .B xv (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2284 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
2285 accelerated playback.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2286 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
2287 the best option.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2288 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2289 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2290 .IPs port=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2291 Select a specific XVideo port.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2292 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2293 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2294 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2295 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2296 .B x11 (X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2297 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
2298 works whenever X11 is present.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2299 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2300 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2301 .B xover (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2302 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
2303 Currently only supported by tdfx_vid.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2304 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2305 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2306 .B xvmc (X11, \-vc ffmpeg12mc only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2307 Video output driver that uses the XvMC (X Video Motion Compensation)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2308 extension of XFree86 4.x to speed up MPEG1/\:2 and VCR2 decoding.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2309 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2310 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2311 .IPs benchmark
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2312 Disables image display.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2313 Necessary for proper benchmarking of drivers that change
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2314 image buffers on monitor retrace only (nVidia).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2315 .IPs queue
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2316 Queue frames for display to allow more parallel work of the video hardware.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2317 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
2318 .IPs sleep
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2319 Use sleep function while waiting for rendering to finish
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2320 (not recomended on Linux).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2321 .IPs wait\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2322 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
2323 (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2324 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2325 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2326 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2327 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2328 .B dga (X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2329 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
2330 Considered obsolete.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2331 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2332 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2333 .B sdl (SDL only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2334 Highly platform independent SDL (Simple Directmedia Layer) library
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2335 video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2336 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2337 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2338 .B vidix\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2339 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
2340 video acceleration features of different graphics cards.
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2341 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
2342 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2343 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2344 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2345 Explicitly choose the VIDIX subdevice driver to use.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2346 Available subdevice drivers are cyberblade_vid, mach64_vid, mga_crtc2_vid,
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2347 mga_vid, nvidia_vid, pm3_vid, radeon_vid, rage128_vid and sis_vid.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2348 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2349 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2350 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2351 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2352 .B xvidix (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2353 X11 frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2354 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2355 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2356 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2357 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2358 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2359 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2360 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2361 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2362 .B cvidix\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2363 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
2364 textconsole with nVidia cards.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2365 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2366 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2367 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2368 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2369 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2370 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2371 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2372 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2373 .B winvidix (Windows only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2374 Windows frontend for VIDIX
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 <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2378 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2379 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2380 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2381 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2382 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2383 .B directx (Windows only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2384 Video output driver that uses the DirectX interface.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2385 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2386 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2387 .IPs noaccel
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2388 Turns off hardware acceleration.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2389 Try this option if you have display problems.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2390 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2391 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2392 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2393 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2394 .B quartz (Mac OS X only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2395 Mac OS X Quartz video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2396 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
2397 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
2398 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2399 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2400 .IPs device_id=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2401 Choose the display device to use in fullscreen.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2402 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2403 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2404 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2405 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2406 .B fbdev (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2407 Uses the kernel framebuffer to play video.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2408 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2409 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2410 .B fbdev2 (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2411 Uses the kernel framebuffer to play video,
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2412 alternative implementation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2413 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2414 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2415 .B vesa\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2416 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
2417 compatible card.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2418 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2419 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2420 .IPs dga\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2421 Turns on DGA mode.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2422 .IPs nodga
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2423 Turns off DGA mode.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2424 .IPs vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2425 FIXME: document this
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2426 .IPs lvo\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2427 FIXME: document this
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2428 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2429 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2430 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2431 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2432 .B svga\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2433 Play video using the SVGA library.
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2434 .PD 0
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2435 .RSs
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2436 .IPs "<video mode>"
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2437 Specify video mode to use.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2438 The mode can be given in a <width>x<height>x<colors> format,
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2439 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2440 .IPs bbosd
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2441 Draw OSD into black bands below the movie (slower).
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2442 .IPs native
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2443 Use only native drawing functions.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2444 This avoids direct rendering, OSD and hardware acceleration.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2445 .IPs retrace
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2446 Force frame switch on vertical retrace.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2447 Usable only with \-double.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2448 It has the same effect as the \-vsync option.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2449 .IPs sq\ \ \
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2450 Try to select a video mode with square pixels.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2451 .IPs vidix
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2452 Use svga with VIDIX.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2453 .RE
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2454 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2455 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2456 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2457 .B gl\ \ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2458 OpenGL video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2459 Very simple version, no OSD support and video size must be smaller than
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2460 the maximum texture size of your OpenGL implementation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2461 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
2462 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2463 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2464 .IPs manyfmts
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2465 Enables support for more (RGB and BGR) color formats.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2466 Needs OpenGL version >= 1.2, NOT yet WORKING correctly.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2467 .IPs slice-height=<0\-...>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2468 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
2469 0 for whole image.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2470 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2471 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2472 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2473 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2474 .B gl2\ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2475 OpenGL video output driver, second generation.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2476 Supports OSD and videos larger than the maximum texture size.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2477 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2478 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2479 .B null\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2480 Produces no video output.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2481 Useful for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2482 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2483 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2484 .B aa\ \ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2485 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
2486 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2487 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2488 .B caca\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2489 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
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 bl\ \ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2493 Video playback using the Blinkenlights UDP protocol.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2494 This driver is highly hardware specific.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2495 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2496 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2497 .B ggi\ \ \ \
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2498 GGI graphics system video output driver
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2499 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2500 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2501 .B directfb
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2502 Play video using the DirectFB library.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2503 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2504 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2505 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2506 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
2507 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2508 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
2509 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
2510 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2511 Single buffering should be avoided (default: single).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2512 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2513 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2514 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
2515 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
2516 like most MPEG movies are.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2517 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
2518 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2519 .IPs layer=N
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2520 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
2521 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2522 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2523 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2524 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2525 .B dfbmga\
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2526 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
2527 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
2528 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
2529 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2530 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2531 .IPs (no)bes
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2532 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
2533 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
2534 picture processing is done in hardware.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2535 Works only on the primary head.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2536 .IPs (no)spic
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2537 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
2538 .IPs (no)crtc2
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2539 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
2540 The output quality is amazing as it's a full interlaced picture
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2541 with proper sync to every odd/\:even field.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2542 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2543 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
2544 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2545 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
2546 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
2547 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2548 Single buffering should be avoided (default: triple).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2549 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2550 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2551 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
2552 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
2553 like most MPEG movies are.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2554 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
2555 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2556 .IPs tvnorm=pal|ntsc|auto
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2557 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
2558 for modifying /etc/\:directfbrc (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2559 Valid norms are pal = PAL, ntsc = NTSC.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2560 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2561 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
2562 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2563 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2564 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2565 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2566 .B mga (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2567 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
2568 end scaler on Gxxx cards through a kernel module.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2569 If you have a Matrox card, this is the fastest option.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2570 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2571 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2572 .B xmga (Linux, X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2573 The mga video output driver, running in an X11 window.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2574 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2575 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2576 .B syncfb\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2577 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
2578 special hardware features of Matrox Gxxx cards like hardware
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2579 deinterlacing, scaling and synchronizing your video output to
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2580 the vertical retrace of your monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2581 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2582 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2583 .B 3dfx (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2584 3Dfx specific video output driver.
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2585 FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2586 .
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2587 .TP
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2588 .B tdfxfb (Linux only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2589 This driver employs the tdfx framebuffer driver to play movies with
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2590 YUV acceleration.
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2591 FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2592 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2593 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2594 .B tdfx_vid (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2595 3Dfx specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2596 Works in conjunction with a kernel module.
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2597 FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2598 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2599 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2600 .B dxr2 (also see \-dxr2) (DXR2 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2601 Creative DXR2 specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2602 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2603 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2604 .IPs x11
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2605 Enables overlay.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2606 .IPs xv
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2607 Enables overlay.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2608 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2609 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2610 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2611 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2612 .B dxr3 (DXR3 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2613 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
2614 Hollywood Plus) specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2615 Also see the lavc video filter.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2616 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2617 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2618 .IPs overlay
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2619 Activates the overlay instead of TVOut.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2620 .IPs prebuf
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2621 Turns on prebuffering.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2622 .IPs sync
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2623 Will turn on the new sync-engine.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2624 .IPs norm=<norm>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2625 Specifies the TV norm.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2626 .RSss
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2627 0: Does not change current norm (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2628 .br
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2629 1: Auto-adjust using PAL/\:NTSC.
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2630 .br
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2631 2: Auto-adjust using PAL/\:PAL-60.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2632 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2633 3: PAL
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2634 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2635 4: PAL-60
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2636 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2637 5: NTSC
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2638 .REss
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2639 .IPs device=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2640 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
2641 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2642 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2643 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2644 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2645 .B mpegpes (DVB only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2646 DVB specific video output driver.
13049
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2647 .PD 0
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2648 .RSs
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2649 .IPs card=<1\-4>
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2650 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
2651 (V3 API only, such as 1.x.y series drivers).
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2652 .RE
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2653 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2654 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2655 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2656 .B zr (also see \-zr* and \-zrhelp)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2657 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
2658 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2659 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2660 .B zr2\ \ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2661 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
2662 second generation.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2663 Also see the zrmjpeg video filter.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2664 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2665 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2666 .B md5\ \ \ \
12944
73cb43ad38ff even better -vo md5 description
diego
parents: 12938
diff changeset
2667 Generates images from each frame with the help of \-vo pgm and writes
73cb43ad38ff even better -vo md5 description
diego
parents: 12938
diff changeset
2668 their MD5 sums into a file.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2669 Useful for debugging.
12934
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2670 .PD 0
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2671 .RSs
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2672 .IPs filename
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2673 Allows specifying the output filename (default: ./md5).
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2674 .RE
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2675 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2676 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2677 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2678 .B yuv4mpeg
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2679 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2680 images and stores it in a file called 'stream.yuv' in the current
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2681 directory.
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2682 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
2683 useful if you want to process the video with the mjpegtools suite.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2684 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2685 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2686 .B gif89a\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2687 Output each frame into a GIF file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2688 Each file takes the frame number padded with leading zeros as name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2689 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2690 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2691 .B jpeg\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2692 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
2693 Each file takes the frame number padded with leading zeros as name.
13247
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2694 .PD 0
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2695 .RSs
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2696 .IPs [no]progressive
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2697 Specify standard or progressive JPEG (default: noprogressive).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2698 .IPs [no]baseline
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2699 Specify use of baseline or not (default: baseline).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2700 .IPs optimize=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2701 optimization factor (default: 100)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2702 .IPs smooth=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2703 smooth factor (default: 0)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2704 .IPs quality=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2705 quality factor (default: 75)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2706 .IPs outdir=<value>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2707 Specify the directory to save the JPEG files to.
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2708 If not specified, all JPEG files are written to the current directory.
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2709 .IPs subdirs=<value>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2710 If specified, MPlayer will create numbered subdirectories with the
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2711 specified prefix.
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2712 If it's not specified, no subdirectories are created
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2713 and all JPEG files are written to the same directory.
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2714 .IPs maxfiles=<value>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2715 Maximum number of JPEG files to be saved per subdirectory in case subdirs
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2716 is specified.
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2717 Must be equal to or larger than 1 (default: 1000).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2718 .RE
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2719 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2720 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2721 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2722 .B pgm\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2723 Output each frame into a PGM file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2724 Each file takes the frame number padded with leading zeros as name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2725 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2726 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2727 .B png\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2728 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
2729 Each file takes the frame number padded with leading zeros as name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2730 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2731 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2732 .B tga\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2733 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
2734 Each file takes the frame number padded with leading zeros as name.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2735 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2736 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2737 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2738 .SH "DECODING/\:FILTERING OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2739 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2740 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2741 .B \-ac <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2742 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
2743 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2744 Use a '-' before the codec name to omit it.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2745 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
2746 contained in the list.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2747 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2748 .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
2749 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
2750 .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
2751 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2752 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2753 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2754 .IPs "\-ac mp3acm"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2755 Force the l3codeca.acm MP3 codec.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2756 .IPs "\-ac mad,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2757 Try libmad first, then fall back on others.
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2758 .IPs "\-ac hwac3,a52,"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2759 Try hardware AC3 passthrough, software AC3, then others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2760 .IPs "\-ac -ffmp3,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2761 Skip FFmpeg's MP3 decoder.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2762 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2763 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2764 .
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
2765 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2766 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2767 Activate a comma separated list of audio filters and their options.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2768 Also see the audio filters section of the documentation.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
2769 .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
2770 Available filters are:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2771 .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
2772 .IPs resample[=srate[:sloppy][:type]]
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2773 Changes the sample rate of the audio stream to an integer srate in Hz.
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
2774 It only supports the 16-bit little-endian format.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2775 .IPs channels[=nch]
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2776 Change the number of channels to nch output channels.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2777 If the number of output channels is bigger than the number of input channels
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2778 empty channels are inserted (except when mixing from mono to stereo, then
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2779 the mono channel is repeated in both of the output channels).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2780 If the number of output channels is smaller than the number of input channels
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2781 the exceeding channels are truncated.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
2782 .IPs format[=bps:f]
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2783 Select the bytes per sample and the format used for output from 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
2784 filter layer.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2785 The option bps is an integer and denotes Bytes per sample.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2786 The format f is a string containing a concatenated mix of:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2787 .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
2788 alaw, mulaw or imaadpcm
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2789 .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
2790 float or int
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2791 .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
2792 unsigned or signed
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2793 .br
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
2794 le or be (little- or big-endian)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2795 .br
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2796 .IPs volume[=v:sc]
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2797 Select the output volume level.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2798 This filter is not reentrant and can therefore only be enabled once for every
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2799 audio stream.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2800 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2801 v: Sets the desired gain in dB for all channels in the stream
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2802 from -200dB to +60dB (where -200dB mutes the sound
12597
5c6185a8d5e8 Better audio filter description, use same values as in the XML docs,
diego
parents: 12595
diff changeset
2803 completely and +60dB equals a gain of 1000).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2804 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2805 sc: Enable soft 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
2806 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2807 .IPs pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2808 Mixes channels arbitrarily, see DOCS/\:HTML/\:en/\:devices.html#audio-dev for details.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2809 .RSss
13245
35a69552ea80 af_pan wants number of _input_ channels, fixes bugzilla bug #22
reimar
parents: 13241
diff changeset
2810 n: number of input channels (1\-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
2811 .br
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2812 lij: How much of input channel j is mixed into output channel i.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2813 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2814 .IPs sub[=fc:ch]
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2815 Add subwoofer channel.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2816 .RSss
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2817 fc: cutoff frequency for low-pass filter (20Hz to 300Hz) (default: 60Hz)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2818 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2819 ch: channel number for the sub-channel
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2820 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2821 .IPs surround[=d]
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2822 Decoder for matrix encoded surround sound, works on many 2 channel files.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2823 .RSss
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2824 d: delay time in ms for the rear speakers (0ms to 1000ms) (default: 15ms)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2825 .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
2826 .IPs delay[=ch1:ch2:...]
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2827 Delays the sound output.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2828 Specify the delay separately for each channel in milliseconds (floating point
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2829 number between 0 and 1000).
11366
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2830 .IPs export[=mmapped_file[:nsamples]]
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2831 Exports the incoming signal to other processes using memory mapping (mmap()).
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2832 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2833 mmapped_file: file to map data to (default: ~/.mplayer/\:mplayer-af_export)
11366
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2834 .br
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2835 nsamples: number of samples per channel (default: 512)
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2836 .REss
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2837 .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
2838 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2839 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
2840 .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
2841 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
2842 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2843 .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
2844 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
2845 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2846 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
2847 .br
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2848 1: Optimize for accuracy.
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2849 .br
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2850 2: Optimize for speed.
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2851 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2852 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
2853 .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
2854 .IPs list=<filters>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
2855 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
2856 .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
2857 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2858 .TP
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2859 .B \-afm <driver1,driver2,...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2860 Specify a priority list of audio codec families to be used, according
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2861 to their codec name in codecs.conf.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2862 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
2863 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2864 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2865 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
2866 .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
2867 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2868 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2869 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2870 .IPs "\-afm ffmpeg"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2871 Try FFmpeg's libavcodec codecs first.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2872 .IPs "\-afm acm,dshow"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2873 Try Win32 codecs first.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2874 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2875 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2876 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2877 .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
2878 .B \-aspect <ratio>
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2879 Override movie aspect ratio.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2880 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
2881 .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
2882 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2883 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2884 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2885 \-aspect 4:3 or \-aspect 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2886 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2887 \-aspect 16:9 or \-aspect 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2888 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2889 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2890 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2891 .TP
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2892 .B \-noaspect
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2893 Disable automatic movie aspect ratio compensation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2894 .
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2895 .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
2896 .B \-flip \
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2897 Flip image upside-down.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2898 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2899 .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
2900 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2901 Specify libavcodec decoding parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2902 .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
2903 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2904 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2905 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2906 \-lavdopts bug=1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2907 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2908 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2909 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
2910 .RS
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2911 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
2912 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2913 .RSs
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2914 .IPs bug=<value>
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2915 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
2916 .RSss
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2917 0: nothing
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2918 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2919 1: autodetect bugs (default)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2920 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2921 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2922 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2923 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2924 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2925 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2926 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2927 16 (mpeg4): padding bug (autodetected)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2928 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2929 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2930 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2931 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2932 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2933 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2934 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2935 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2936 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2937 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2938 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2939 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2940 .REss
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2941 .IPs debug=<value>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2942 debug:
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2943 .RSss
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2944 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2945 0: disabled
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2946 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2947 1: picture info
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2948 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2949 2: rate control
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2950 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2951 4: bitstream
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2952 .br
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
2953 8: macroblock (MB) type
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
2954 .br
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
2955 16: quantizer parameter (QP)
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
2956 .br
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
2957 32: motion vector
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2958 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2959 0x0040: motion vector visualization (use \-noslices)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2960 .br
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
2961 0x0080: macroblock (MB) skip
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2962 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2963 0x0100: startcode
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2964 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2965 0x0200: PTS
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2966 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2967 0x0400: error resilience
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2968 .br
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2969 0x0800: memory management control operations (H.264)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2970 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2971 0x1000: bugs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2972 .REss
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
2973 .IPs ec=<value>
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2974 error concealment:
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2975 .RSss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2976 1: Use strong deblock filter for damaged MBs.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2977 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2978 2: iterative motion vector (MV) search (slow)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2979 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2980 3: all (default)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2981 .REss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2982 .IPs er=<value>
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2983 error resilience:
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2984 .RSss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2985 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2986 0: disabled
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2987 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2988 1: careful (Should work with broken encoders.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2989 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2990 2: normal (default) (Works with compliant encoders.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2991 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2992 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2993 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2994 4: very aggressive
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
2995 .REss
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
2996 .IPs fast\
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
2997 Enable optimizations that do not comply to the specification and might
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
2998 potentially cause problems, like simpler dequantization, assuming use
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
2999 of the default quantization matrix, assuming YUV 4:2:0, skipping a few
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3000 checks to detect damaged bitstreams).
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3001 .IPs gray\
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3002 grayscale only decoding (a bit faster than with color)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3003 .IPs "idct=<0\-99> (see \-lavcopts)"
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3004 For best decoding quality use the same idct algorithm for decoding and encoding.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3005 This may come at a price in accuracy, though.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3006 .IPs "sb=<number> (MPEG2 only)"
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3007 Skip the given number of macroblock rows at the bottom.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3008 .IPs "st=<number> (MPEG2 only)"
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3009 Skip the given number of macroblock rows at the top.
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3010 .IPs vismv=<value>
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3011 vismv:
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3012 .RSss
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3013 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3014 0: disabled
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3015 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3016 1: visualize forward predicted MVs of P frames
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3017 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3018 2: visualize forward predicted MVs of B frames
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3019 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3020 4: visualize backward predicted MVs of B frames
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3021 .REss
13036
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
3022 .IPs vstats
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
3023 Prints some statistics and stores them in ./vstats_*.log.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3024 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3025 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3026 .TP
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3027 .B \-noslices
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3028 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
3029 whole frame in a single run.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3030 May be faster or slower, depending on card/\:cache.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3031 It has effect only with libmpeg2 and libavcodec codecs.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3032 .
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3033 .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
3034 .B \-nosound
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3035 Do not play/\:encode sound.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
3036 Useful for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3037 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3038 .TP
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3039 .B \-novideo
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3040 Do not play/\:encode video.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3041 .
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3042 .TP
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
3043 .B \-oldpp <quality> (OpenDivX only) (OBSOLETE)
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3044 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
3045 Superseded by \-pp, the internal postprocessing offers better
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3046 quality and performance.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3047 The valid range of \-oldpp values varies by codec, it is mostly
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3048 0\-6, where 0=disable, 6=slowest/\:best.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3049 .
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3050 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3051 .B \-pp <quality> (also see \-vf pp)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3052 Set the DLL postprocess level.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3053 This option is no longer usable with \-vf pp.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3054 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3055 The valid range of \-pp values varies by codec, it is mostly
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3056 0\-6, where 0=disable, 6=slowest/\:best.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3057 .
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
3058 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3059 .B \-pphelp (also see \-vf pp)
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
3060 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
3061 .
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
3062 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
3063 .B \-ssf <mode>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3064 Specifies SwScaler parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3065 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3066 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3067 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3068 .RSs
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3069 \-vf scale \-ssf lgb=3.0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3070 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3071 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3072 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3073 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3074 .IPs lgb=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3075 Gaussian blur filter (luma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3076 .IPs cgb=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3077 Gaussian blur filter (chroma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3078 .IPs ls=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3079 sharpen filter (luma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3080 .IPs cs=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3081 sharpen filter (chroma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3082 .IPs chs=<h>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3083 chroma horizontal shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3084 .IPs cvs=<v>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3085 chroma vertical shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3086 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3087 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3088 .
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
3089 .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
3090 .B \-stereo <mode>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3091 Select type of MP2/\:MP3 stereo output.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3092 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3093 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3094 .IPs 0
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3095 stereo
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3096 .IPs 1
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3097 left channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3098 .IPs 2
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3099 right channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3100 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3101 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3102 .
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
3103 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3104 .B \-sws <software\ scaler\ type> (also see \-vf scale and \-zoom)
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3105 Specify the software scaler algorithm to be used with the \-zoom option.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3106 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3107 .sp 1
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3108 Available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3109 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3110 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3111 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3112 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3113 fast bilinear (default)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3114 .IPs 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3115 bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3116 .IPs 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3117 bicubic (good quality)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3118 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3119 experimental
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3120 .IPs 4
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3121 nearest neighbour (bad quality)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3122 .IPs 5
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3123 area
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3124 .IPs 6
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3125 luma bicubic / chroma bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3126 .IPs 7
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3127 gauss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3128 .IPs 8
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3129 sincR
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3130 .IPs 9
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3131 lanczos
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3132 .IPs 10
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3133 bicubic spline
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3134 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3135 .PD 1
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3136 .sp 1
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3137 .RS
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3138 .I NOTE:
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3139 For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p)
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3140 of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3141 length (1 \- 10).
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3142 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3143 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3144 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
3145 .B \-vc <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3146 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
3147 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3148 Use a '-' before the codec name to omit it.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3149 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
3150 contained in the list.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3151 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3152 .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
3153 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
3154 .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
3155 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3156 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3157 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3158 .IPs "\-vc divx"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3159 Force Win32/\:VFW DivX codec, no fallback.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3160 .IPs "\-vc divx4,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3161 Try divx4linux codec first, then fall back on others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3162 .IPs "\-vc -divxds,-divx,"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3163 Skip Win32 DivX codecs.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3164 .IPs "\-vc ffmpeg12,mpeg12,"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3165 Try libavcodec's MPEG1/\:2 codec, then libmpeg2, then others.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3166 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3167 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3168 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3169 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3170 .B \-vfm <driver1,driver2,...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3171 Specify a priority list of video codec families to be used, according
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3172 to their names in codecs.conf.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3173 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
3174 .br
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3175 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3176 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
3177 .sp 1
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3178 .I EXAMPLE:
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3179 .PD 0
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3180 .RSs
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3181 .IPs "\-vfm ffmpeg,dshow,vfw"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3182 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
3183 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
3184 .IPs "\-vfm xanim"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3185 Try XAnim codecs first.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3186 .RE
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3187 .PD 1
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3188 .
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3189 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
3190 .B \-x <x> (MPlayer only)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3191 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
3192 Disables aspect calculations.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3193 .
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
3194 .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
3195 .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
3196 Specify additional parameters when decoding with XviD.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3197 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3198 .RSs
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3199 .IPs deblock-chroma
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
3200 Activate XviD internal postprocessing filter: chroma deblock filter.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3201 See also \-vf pp, which is faster than XviD's own filter.
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3202 .IPs deblock-luma
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
3203 Activate XviD internal postprocessing filter: luma deblock filter.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3204 See also \-vf pp, which is faster than XviD's own filter.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3205 .IPs dr2\ \
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3206 Activate direct rendering method 2.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3207 .IPs nodr2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3208 Deactivate direct rendering method 2.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3209 .IPs filmeffect
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3210 Activate XviD internal film grain effect.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3211 Adds artificial film grain to the video.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3212 May increase perceived quality, while lowering true quality.
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
3213 Also see \-vf noise.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3214 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3215 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3216 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3217 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3218 .B \-xy <value>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3219 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3220 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3221 .IPs value<=8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3222 Scale image by factor <value>.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3223 .IPs value>8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3224 Set width to value and calculate height to keep correct aspect ratio.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3225 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3226 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3227 .
6310
eda1e909a3bf -stop_xscreensaver option
diego
parents: 6268
diff changeset
3228 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
3229 .B \-y <y> (MPlayer only)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3230 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
3231 Disables aspect calculations.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3232 .
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
3233 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3234 .B \-zoom\ \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3235 Allow software scaling, where available.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3236 Can be used to force scaling with \-vf scale.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3237 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3238 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3239 \-vf scale will ignore \-x / \-y / \-xy / \-fs / \-aspect without
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3240 \-zoom.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3241 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3242 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3243 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3244 .SH "VIDEO FILTERS"
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3245 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
3246 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3247 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3248 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3249 .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
3250 Setup a chain of video filters.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3251 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3252 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3253 .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
3254 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
3255 .B reverse
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3256 order.
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3257 Deprecated in favor of \-vf.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3258 .PP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3259 Many parameters are optional and set to default values if omitted.
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3260 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
3261 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
3262 from the upper left corner of the bigger image.
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3263 .br
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3264 .I NOTE:
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3265 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
3266 .sp 1
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3267 Filters are managed in lists.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3268 There are a few commands to manage the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3269 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3270 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3271 .B \-vf-add <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3272 Appends the filters given as arguments to the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3273 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3274 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3275 .B \-vf-pre <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3276 Prepends the filters given as arguments to the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3277 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3278 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3279 .B \-vf-del <index1[,index2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3280 Deletes the filters at the given indexes.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3281 Index numbers start at 0, negative numbers address the end of the
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3282 list (-1 is the last).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3283 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3284 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3285 .B \-vf-clr
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3286 Completely empties the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3287 .PP
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3288 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
3289 .
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3290 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3291 .B \-vf <filter>=help
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3292 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
3293 filter.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3294 .
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3295 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3296 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3297 Sets a named parameter to the given value.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3298 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
3299 .PP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3300 Available filters are:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3301 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3302 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3303 .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
3304 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
3305 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
3306 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3307 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3308 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3309 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
3310 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3311 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
3312 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3313 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3314 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3315 .TP
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3316 .B cropdetect[=limit:round]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3317 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
3318 to stdout.
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3319 .PD 0
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3320 .RSs
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3321 .IPs limit
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3322 Threshold, which can be optionally specified from nothing (0) to
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3323 everything (255) (default: 24).
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3324 .br
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3325 .IPs round
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3326 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
3327 The offset is automatically adjusted to center the video.
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3328 Use 2 to get only even dimensions (needed for 4:2:2 video).
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3329 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
3330 .RE
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3331 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3332 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3333 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3334 .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
3335 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
3336 that takes two parameters.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3337 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3338 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3339 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3340 width and height (default: -1, maximum possible width where boundaries
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3341 are still visible.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3342 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3343 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
3344 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3345 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3346 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3347 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3348 .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
3349 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
3350 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
3351 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
3352 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3353 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3354 expanded width,height (default: original width,height).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3355 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
3356 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3357 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3358 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3359 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3360 .IP expand=0:-50:0:0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3361 adds a 50 pixel border to the bottom of the picture
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3362 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3363 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3364 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3365 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
3366 .IPs o
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3367 OSD/\:subtitle rendering
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3368 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3369 0: disable (default)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3370 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3371 1: enable
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3372 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3373 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3374 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3375 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3376 .B flip\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3377 Flips the image upside down.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3378 See also option \-flip.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3379 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3380 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3381 .B mirror\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3382 Mirrors the image on the Y axis.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3383 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3384 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3385 .B rotate[=<0\-7>]
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3386 Rotates and flips (optional) the image +/\:- 90 degrees.
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3387 For parameters between 4\-7 rotation is only done if the movie's geometry is
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3388 portrait and not landscape.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3389 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3390 .TP
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3391 .B scale[=w:h[:interlaced[:chr_drop[:param[:presize]]]]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3392 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3393 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
3394 .RSs
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3395 .IPs w,h\ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3396 scaled width/\:height (default: original width/\:height)
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3397 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3398 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3399 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
3400 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
3401 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3402 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
3403 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3404 -1: original width/\:height
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3405 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3406 -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
3407 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3408 -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
3409 .REss
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3410 .IPs interlaced
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3411 Toggle interlaced scaling.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3412 .IPs chr_drop
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3413 chroma skipping
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3414 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3415 0: use all available input lines for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3416 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3417 1: use only every 2. input line for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3418 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3419 2: use only every 4. input line for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3420 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3421 3: use only every 8. input line for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3422 .REss
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3423 .IPs param
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3424 scaling parameter (depends upon the scaling method used)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3425 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3426 \-sws 2 (bicubic): 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
3427 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3428 \-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
3429 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3430 \-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
3431 .REss
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3432 .IPs presize
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3433 Scale to preset sizes.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3434 .RSss
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3435 qntsc: 352x240 (NTSC quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3436 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3437 qpal: 352x288 (PAL quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3438 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3439 ntsc: 720x480 (standard NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3440 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3441 pal: 720x576 (standard PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3442 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3443 sntsc: 640x480 (square pixel NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3444 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3445 spal: 768x576 (square pixel PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3446 .REss
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3447 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3448 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3449 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3450 .B dsize={aspect|w:h}
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3451 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
3452 filter chain.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3453 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
3454 (1.33).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3455 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
3456 desired.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3457 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
3458 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
3459 correct aspect.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3460 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3461 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3462 .B yuy2\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3463 Forces software YV12/\:I420 or 422P to YUY2 conversion.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3464 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
3465 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3466 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3467 .B yvu9\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3468 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
3469 Deprecated in favor of the software scaler.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3470 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3471 .TP
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3472 .B yuvcsp\
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3473 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
3474 .
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3475 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3476 .B rgb2bgr[=swap]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3477 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
3478 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3479 .RSs
12559
diego
parents: 12558
diff changeset
3480 .IPs swap\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3481 Also perform R <\-> B swapping.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3482 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3483 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3484 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3485 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3486 .B palette
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3487 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
3488 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3489 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3490 .B format[=fourcc]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3491 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
3492 Use together with the scale filter for a real conversion.
11313
b4fad475a89d Add -vf format=fmt=help hint.
diego
parents: 11302
diff changeset
3493 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
3494 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3495 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3496 .IPs fourcc
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3497 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
3498 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3499 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3500 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3501 .TP
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3502 .B noformat[=fourcc]
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3503 Restricts the colorspace for the next filter without doing any conversion.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3504 Unlike the format filter, this will allow any colorspace
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3505 .B except
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3506 the one you specify.
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3507 For a list of available formats see noformat=fmt=help.
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3508 .PD 0
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3509 .RSs
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3510 .IPs fourcc
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3511 format name like rgb15, bgr24, yv12, etc (default: yv12)
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3512 .RE
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3513 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3514 .
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3515 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3516 .B pp[=filter1[:option1[:option2...]]/\:[-]filter2...] (also see \-pphelp)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3517 This option enables usage of MPlayer's internal postprocessing filter,
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3518 and also gives an interface where you can pass options to the named filter.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3519 Subfilters must be separated by /.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3520 Each filter defaults to 'c' (chrominance).
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3521 The keywords accept a '-' prefix to disable the option.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3522 A ':' followed by a letter may be appended to the option to indicate its
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3523 scope:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3524 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3525 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3526 .IPs a
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3527 Automatically switches the filter off if the CPU is too slow.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3528 .IPs c
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3529 Do chrominance filtering, too.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3530 .IPs y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3531 Do not do chrominance filtering (only luminance filtering).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3532 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3533 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3534 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3535 .RS
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3536 .br
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3537 .I NOTE:
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3538 \-pphelp shows a list of available postprocessing filters.
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3539 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3540 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3541 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3542 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3543 .RSs
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3544 .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
3545 horizontal and vertical deblocking, deringing and automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3546 brightness/\:contrast
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3547 .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
3548 horizontal and vertical deblocking, deringing, automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3549 brightness/\:contrast and linear blend deinterlacer
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3550 .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
3551 default filters without brightness/\:contrast correction
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3552 .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
3553 Enable default filters & temporal denoiser.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3554 .IPs "\-vf pp=hb:y/\:vb:a \-autoq 6"
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3555 Deblock horizontal only luminance and switch vertical deblocking on or
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3556 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
3557 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3558 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3559 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3560 .TP
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3561 .B spp[=quality[:qp[:mode]]]
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3562 simple postprocessing filter
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3563 .RSs
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3564 .IPs quality
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3565 0\-6 (default: 3)
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3566 .IPs qp\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3567 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
3568 .IPs mode\ \ \
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3569 0: hard thresholding (default)
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3570 .br
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3571 1: soft thresholding (better deringing, but blurrier)
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3572 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3573 .
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3574 .TP
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
3575 .B qp=equation
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3576 quantizer parameter (QP) change filter
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3577 .RSs
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
3578 .IPs equation
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3579 some equation like "2+2*sin(PI*qp)"
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3580 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3581 .
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3582 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3583 .B test\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3584 Generate various test patterns.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3585 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3586 .TP
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3587 .B rgbtest
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3588 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
3589 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
3590 .
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3591 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3592 .B lavc[=quality:fps]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3593 Fast software YV12 to MPEG1 conversion with libavcodec for use with DVB/\:DXR3.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3594 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
3595 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3596 .IPs quality
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3597 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3598 1\-31: fixed qscale
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3599 .br
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3600 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
3601 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3602 .IPs fps\ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3603 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
3604 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3605 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3606 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3607 .B fame\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3608 Fast software YV12 to MPEG1 conversion with libfame for use with DVB/\:DXR3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3609 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3610 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3611 .B dvbscale[=aspect]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3612 Set up optimal scaling for DVB cards, scaling the X axis in hardware and
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3613 calculating the Y axis scaling in software to keep aspect.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3614 It's only useful together with expand+scale
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3615 (\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3616 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3617 .IPs aspect
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
3618 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3619 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
3620 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3621 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3622 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3623 .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
3624 Adds noise.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3625 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3626 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3627 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3628 luma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3629 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3630 chroma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3631 .IPs u
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3632 uniform noise (gaussian otherwise)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3633 .IPs t
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3634 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
3635 .IPs a
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3636 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
3637 .IPs h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3638 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
3639 .IPs p
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3640 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
3641 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3642 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3643 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3644 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3645 .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
3646 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
3647 images really still (This should enhance compressibility.).
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3648 It can be given from 0 to 3 parameters.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3649 If you omit a parameter, a reasonable value will be inferred.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3650 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3651 .RSs
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3652 .IPs luma\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3653 spatial luma strength (default = 4)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3654 .IPs chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3655 spatial chroma strength (default = 3)
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3656 .IPs time\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3657 temporal strength (default = 6)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3658 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3659 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3660 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3661 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3662 .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
3663 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
3664 Parameters and usage are the same.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3665 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3666 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3667 .B eq[=bright:cont]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3668 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
3669 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
3670 contrast controls in hardware.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3671 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
3672 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
3673 with lower bitrates.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3674 Initial values in the range -100\-100 may be given on the command line.
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
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
3677 .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
3678 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
3679 allowing gamma correction in addition to simple brightness
c934dadd77c2 -vf eq only supports brightness and contrast, noticed by Torinthiel.
diego
parents: 11095
diff changeset
3680 and contrast adjustment.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3681 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
3682 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
3683 The parameters are given as floating point values.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3684 Parameters rg, gg, bg are the independent gamma values for the Red, Green
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3685 and Blue components.
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
3686 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
3687 bright image areas, e.g.\& keep them from getting overamplified and just plain
11609
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
3688 white.
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
3689 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
3690 at its full strength.
11424
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
3691 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
3692 weight=1.0.
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
3693 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
3694 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
3695 weight.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3696 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3697 .TP
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3698 .B hue[=hue:saturation]
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3699 Defaults are hue=0.0, saturation=1.0.
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3700 Value ranges are -180\-180 for hue, -2\-2 for saturation (negative values result
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
3701 in a negative chroma).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3702 .
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3703 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3704 .B halfpack[=f]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3705 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
3706 keeping all chroma samples.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3707 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
3708 is poor quality or is not available.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3709 Can also be used as a primitive luma-only deinterlacer with very low cpu
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3710 usage.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3711 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
3712 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
3713 odd lines.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3714 Any other value for f gives the default (averaging) behavior.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3715 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3716 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
3717 .B ilpack[=mode]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3718 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
3719 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
3720 the chroma channels.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3721 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
3722 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
3723 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
3724 The optional argument selects the sampling mode.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
3725 By default, linear interpolation (mode 1) is used.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
3726 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
3727 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3728 .TP
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3729 .B harddup
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3730 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3731 If harddup is used when encoding, it will force duplicate frames to be
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3732 encoded in the output.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3733 This uses slightly more space, but is necessary for output to MPEG
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3734 files or if you plan to demux and remux the video stream after
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3735 encoding.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3736 Should be placed at or near the end of the filter chain unless you
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3737 have a good reason to do otherwise.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3738 .
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3739 .TP
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3740 .B softskip
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3741 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3742 Softskip moves the frame skipping (dropping) step of encoding from
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3743 before the filter chain to some point during the filter chain.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3744 This allows filters which need to see all frames (inverse telecine,
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3745 temporal denoising, etc.) to function properly.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3746 Should be placed after the filters which need to see all frames and
12559
diego
parents: 12558
diff changeset
3747 before any subsequent filters that are CPU-intensive.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3748 .
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3749 .TP
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3750 .B decimate[=max:hi:lo:frac]
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3751 Drops frames that don't differ greatly from the previous frame in
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3752 order to reduce framerate.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3753 The argument max (if positive) sets the maximum number of consecutive
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3754 frames which can be dropped, or (if negative) the minimum interval
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3755 between dropped frames.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3756 A frame is a candidate for dropping if no 8x8 region differs by more
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3757 than a threshold of hi, and if not more than frac portion (1 meaning
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3758 the whole image) differs by more than a threshold of lo.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3759 Values of hi and lo are for 8x8 pixel blocks and represent actual
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3760 pixel value differences, so a threshold of 64 corresponds to 1 unit of
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3761 difference for each pixel, or the same spread out differently over the
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3762 block.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3763 The main use of this filter is for very-low-bitrate encoding (e.g.\&
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3764 streaming over dialup modem), but it could in theory be used for
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3765 fixing movies that were inverse-telecined incorrectly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3766 .
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3767 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3768 .B dint[=sense:level]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3769 Detects and drops first of interlaced frames in video stream.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3770 Values can be from 0.0 to 1.0 \- first (default 0.1) is relative difference
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3771 between neighbor pixels, second (default 0.15) is what part of image have to
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3772 be detected as interlaced to drop the frame.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3773 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3774 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3775 .B lavcdeint
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3776 Use libavcodec's deinterlace filter.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3777 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3778 .TP
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
3779 .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
3780 Donald Graft's adaptive kernel deinterlacer.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3781 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
3782 .PD 0
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3783 .RSs
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
3784 .IPs "thresh (0 - 255)"
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
3785 Threshold (default 10).
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3786 .IPs "map (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3787 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
3788 .IPs "order (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3789 Swap fields if 1 (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3790 .IPs "sharp (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3791 Enable additional sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3792 .IPs "twoway (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3793 Enable twoway sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3794 .RE
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3795 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3796 .
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3797 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3798 .B unsharp=l|cWxH:amount[:l|cWxH:amount]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3799 Unsharp mask / gaussian blur.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3800 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3801 .IPs l
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3802 Apply effect on luma component.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3803 .IPs c
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3804 Apply effect on chroma components.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3805 .IPs WxH
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3806 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
3807 (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
3808 .IPs amount
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3809 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
3810 (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
3811 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3812 <0: blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3813 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3814 >0: sharpen
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3815 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3816 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3817 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3818 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3819 .B swapuv\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3820 Swap U & V plane.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3821 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3822 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3823 .B il=[d|i][s][:[d|i][s]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3824 (de)interleaves lines.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3825 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
3826 pre-field without deinterlacing them.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3827 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
3828 interlacing.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3829 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
3830 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
3831 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
3832 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
3833 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3834 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3835 .IPs d
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3836 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
3837 .IPs i
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3838 interleave
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3839 .IPs s
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3840 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
3841 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3842 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3843 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3844 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3845 .B fil=[i|d]
11251
731652167590 -vf fil
michael
parents: 11247
diff changeset
3846 (de)interleaves lines.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3847 This filter is very similar to the il filter but much faster, the main
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3848 disadvantage is that it doesn't always work.
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3849 Especially if combined with other filters it may produce randomly messed
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3850 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
3851 your combination of filters.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3852 .PD 0
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3853 .RSs
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3854 .IPs d
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3855 Deinterleave fields, placing them side by side.
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3856 .IPs i
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3857 Interleave fields again (reversing the effect of fil=d).
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3858 .RE
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3859 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3860 .
11251
731652167590 -vf fil
michael
parents: 11247
diff changeset
3861 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3862 .B field[=n]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3863 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
3864 to avoid wasting CPU time.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3865 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
3866 field (depending on whether n is even or odd).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3867 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3868 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3869 .B detc[=var1=value2:var2=value2:...]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3870 Attempts to reverse the 'telecine' process to recover a clean,
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3871 non-interlaced stream at film framerate.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3872 This was the first and most primitive inverse telecine filter to be
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3873 added to MPlayer/\:MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3874 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
3875 long as possible.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3876 This makes it suitable for perfectly-telecined material, even in the
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3877 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
3878 of complex post-telecine edits.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3879 Development on this filter is no longer taking place, as ivtc, pullup,
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3880 and filmdint are better for most applications.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3881 The following arguments (see syntax above) may be used to control
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3882 detc's behavior:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3883 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3884 .IPs dr
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3885 Set the frame dropping mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3886 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
3887 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
3888 merges in the past 5 frames.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3889 2 means always maintain exact 5:4 input to output frame ratio.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3890 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3891 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3892 Use mode 1 or 2 with MEncoder.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3893 .IPs am
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3894 Analysis mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3895 Available values are 0 (fixed pattern with initial frame number
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3896 specified by fr=#) and 1 (agressive search for telecine pattern).
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3897 Default is 1.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3898 .IPs fr
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3899 Set initial frame number in sequence.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3900 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
3901 interlaced frames.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3902 The default, -1, means 'not in telecine sequence'.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3903 The number specified here is the type for the imaginary previous
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3904 frame before the movie starts.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3905 .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
3906 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
3907 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3908 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3909 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3910 .B ivtc[=1]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3911 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
3912 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
3913 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
3914 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
3915 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
3916 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
3917 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
3918 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
3919 As with detc, you must specify the correct output framerate (\-ofps
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
3920 23.976) when using MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3921 Further development on ivtc has stopped, as the pullup and filmdint
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3922 filters appear to be much more accurate.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3923 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3924 .TP
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3925 .B pullup[=jl:jr:jt:jb:sb]\
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3926 Third-generation pulldown reversal (inverse telecine) filter,
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3927 capable of handling mixed hard-telecine, 24 fps progressive, and 30
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3928 fps progressive content.
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3929 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
3930 ivtc, by taking advantage of future context in making its decisions.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3931 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
3932 a pattern to follow, but it instead looks forward to the following
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3933 fields in order to identify matches and rebuild progressive frames.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3934 It is still under development, but believed to be quite accurate.
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3935 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
3936 the left, right, top, and bottom of the image, respectively.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3937 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
3938 2 lines.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3939 The default is 8 pixels on each side.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3940 Setting the sb (strict breaks) option to 1 will reduce the chances of
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3941 pullup generating an occasional mismatched frame, but it may also
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3942 cause an excessive number of frames to be dropped during high motion
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3943 sequences.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
3944 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3945 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3946 Always follow pullup with the softskip filter when encoding to ensure
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3947 that pullup is able to see each frame.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3948 Failure to do so will lead to incorrect output and will usually crash,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3949 due to design limitations in the codec/\:filter layer.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3950 .
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3951 .TP
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3952 .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
3953 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
3954 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
3955 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
3956 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
3957 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
3958 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
3959 approximation.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
3960 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
3961 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
3962 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
3963 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
3964 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
3965 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
3966 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
3967 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
3968 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
3969 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
3970 .RSs
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3971 .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
3972 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
3973 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
3974 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
3975 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
3976 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
3977 .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
3978 For each ifps input frames the filter will output ofps frames.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3979 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
3980 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
3981 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
3982 .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
3983 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
3984 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
3985 fields.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3986 .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
3987 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
3988 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
3989 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
3990 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
3991 .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
3992 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
3993 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
3994 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
3995 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
3996 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
3997 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
3998 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
3999 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
4000 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
4001 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
4002 much accuracy.
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
4003 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
4004 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
4005 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
4006 .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
4007 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
4008 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
4009 .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
4010 Deinterlace threshold.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4011 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
4012 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
4013 deinterlacing.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4014 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
4015 .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
4016 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
4017 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
4018 .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
4019 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
4020 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
4021 .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
4022 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
4023 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4024 .
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4025 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4026 .B softpulldown
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4027 This filter works only correct with MEncoder and acts on the MPEG2 flags
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4028 used for soft 3:2 pulldown (soft telecine).
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4029 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
4030 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
4031 .
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4032 .TP
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4033 .B divtc[=options]
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4034 Inverse telecine for deinterlaced video.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4035 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
4036 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
4037 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
4038 This filter is intended to find and drop those duplicates and restore the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4039 original film framerate.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4040 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
4041 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
4042 The options are:
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4043 .RSs
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4044 .IPs pass=1|2
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4045 Use two-pass mode.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4046 This produces best results.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4047 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
4048 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
4049 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
4050 process.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4051 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
4052 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
4053 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
4054 .IPs file=filename
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4055 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
4056 .IPs threshold=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4057 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
4058 believe in it (default: 0.5).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4059 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
4060 that are very dark or very still.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4061 .IPs window=numframes
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4062 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
4063 (default: 30).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4064 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
4065 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
4066 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
4067 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
4068 and past.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4069 .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
4070 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
4071 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
4072 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
4073 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
4074 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
4075 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
4076 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
4077 .IPs deghost=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4078 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
4079 mode, default 0).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4080 If nonzero, deghosting mode is used.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4081 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
4082 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
4083 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
4084 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
4085 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
4086 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
4087 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
4088 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
4089 absolute value of the parameter.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4090 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
4091 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4092 .
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4093 .TP
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4094 .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
4095 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
4096 changes.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4097 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
4098 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
4099 The options are:
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4100 .RSs
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4101 .IPs t
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4102 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
4103 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
4104 .IPs b
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4105 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
4106 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
4107 .IPs p
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4108 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
4109 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
4110 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
4111 .IPs a
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4112 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
4113 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
4114 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
4115 .IPs u
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4116 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
4117 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
4118 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
4119 fields.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4120 .IPs T
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4121 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
4122 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
4123 .IPs B
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4124 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
4125 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
4126 .IPs A
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4127 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
4128 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
4129 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
4130 This is the default mode.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4131 .IPs U
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4132 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
4133 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
4134 .IPs v
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4135 Verbose operation.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4136 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
4137 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
4138 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4139 .
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4140 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4141 .B telecine[=start]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4142 Apply 3:2 'telecine' process to increase framerate by 20%.
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4143 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
4144 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
4145 Both fps options are essential!
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4146 (A/\:V sync will break if they are wrong.)
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4147 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
4148 pattern to start (0\-3).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4149 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4150 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4151 .B tinterlace[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4152 Temporal field interlacing \- merge pairs of frames into an interlaced
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4153 frame, halving the framerate.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4154 Even frames are moved into the upper field, odd frames to the lower field.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4155 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
4156 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
4157 .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
4158 .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
4159 .IPs 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
4160 odd frames into upper field, even to lower, generating a full-height
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
4161 frame at half the framerate
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
4162 .IPs 1
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
4163 only output odd frames, even frames are dropped, height unchanged
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
4164 .IPs 2
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
4165 only output even frames, odd frames are dropped, height unchanged
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
4166 .IPs 3
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
4167 expand each frame to full height, but pad alternate lines with black,
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
4168 framerate unchanged
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
4169 .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
4170 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4171 .
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
4172 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4173 .B tfields[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4174 Temporal field separation \- split fields into frames, doubling the
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4175 output framerate.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4176 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
4177 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
4178 desired (double) framerate!
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4179 Available modes are:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4180 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4181 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4182 .IPs 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4183 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
4184 .IPs 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4185 interpolate missing lines (the algorithm used might not be so good)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4186 .IPs 2
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4187 translate fields by 1/\:4 pixel with linear interp (no jump)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4188 .IPs 4
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4189 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
4190 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4191 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4192 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4193 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4194 .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
4195 box blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4196 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4197 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4198 .IPs radius
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4199 size of the filter
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4200 .IPs power
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4201 How often the filter should be applied.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4202 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4203 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4204 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4205 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4206 .B sab=rad:pf:colorDiff[:rad:pf:colorDiff]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4207 shape adaptive blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4208 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4209 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4210 .IPs rad\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4211 blur filter strength (~0.1\-4.0) (slower if larger)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4212 .IPs pf\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4213 prefilter strength (~0.1\-2.0)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4214 .IPs colorDiff
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4215 How different the pixels are allowed to be considered.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4216 (~0.1\-100.0)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4217 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4218 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4219 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4220 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4221 .B smartblur=rad:strength:thresh[:rad:strength:thresh]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4222 smart blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4223 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4224 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4225 .IPs rad\ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4226 blur filter strength (~0.1\-5.0) (slower if larger)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4227 .IPs strength
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4228 blur (0.0\-1.0) or sharpen (-1.0\-0.0)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4229 .IPs thresh
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4230 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
4231 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4232 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4233 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4234 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4235 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4236 perspective correction
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4237 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4238 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4239 .IPs x0,y0,...
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4240 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
4241 .IPs t\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4242 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
4243 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4244 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4245 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4246 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4247 .B 2xsai\ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4248 Use the 2x scale and interpolate algorithm for scaling and smoothing images.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4249 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4250 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4251 .B 1bpp\ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4252 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4253 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4254 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4255 .B down3dright[=lines]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4256 Reposition and resize stereoscopic images.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4257 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
4258 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
4259 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4260 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4261 .IPs lines
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4262 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
4263 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4264 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4265 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4266 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4267 .B bmovl=hidden:opaque:<fifo>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4268 Read bitmaps from a FIFO and display them in a window.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4269 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4270 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4271 .IPs hidden
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4272 sets the default value of the 'hidden' flag (boolean)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4273 .IPs opaque
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4274 flag switching between alphablended (transparent) and opaque (fast) mode
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4275 .IPs fifo\
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4276 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
4277 controlling application)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4278 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4279 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4280 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4281 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4282 FIFO commands are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4283 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4284 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4285 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4286 .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
4287 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
4288 .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
4289 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
4290 .IPs "RGB24 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
4291 followed by width*height*3 Bytes of raw RGB32 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4292 .IPs "BGR24 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
4293 followed by width*height*3 Bytes of raw BGR32 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4294 .IPs "ALPHA width height xpos ypos alpha"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4295 change alpha for area
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4296 .IPs "CLEAR width height xpos ypos"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4297 clear area
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4298 .IPs OPAQUE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4299 disable all alpha transparency.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4300 Send "ALPHA 0 0 0 0 0" to enable it again.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4301 .IPs HIDE\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4302 hide bitmap
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4303 .IPs SHOW\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4304 show bitmap
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4305 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4306 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4307 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4308 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4309 Arguments are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4310 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4311 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4312 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4313 .IPs "width, height"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4314 size of image/\:area
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4315 .IPs "xpos, ypos"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4316 start blitting at X/\:Y position
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4317 .IPs alpha
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4318 Set alpha difference.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4319 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
4320 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
4321 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4322 0: same as original
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4323 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4324 255: makes everything opaque
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4325 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4326 -255: makes everything transparent
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4327 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4328 .IPs clear
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4329 clear the framebuffer before blitting.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4330 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4331 0: The image will just be blitted on top of the old one, so you don't need to
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4332 send 1,8MB of RGBA32 data everytime a small part of the screen is updated.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4333 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4334 1: clear
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4335 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4336 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4337 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4338 .
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4339 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4340 .B framestep=I|[i]step
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4341 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
4342 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4343 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
4344 keyframes are rendered.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4345 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
4346 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
4347 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
4348 .sp 1
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
4349 When a keyframe is found, an 'I!' string followed by a newline character is
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4350 printed, leaving the current line of mplayer/\:mencoder output on the screen,
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4351 because it contains the time (in seconds) and frame number of the keyframe
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4352 (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
4353 .sp 1
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4354 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
4355 every 'step' frames is rendered.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4356 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4357 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
4358 (like the I parameter).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4359 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4360 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
4361 printed.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4362 .
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4363 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4364 .B tile=xtile:ytile:output:start:delta
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4365 Tile a series of images into a single, bigger image.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4366 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
4367 value is used.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4368 You can also stop when you're OK (... \-vf tile=10:5 ...).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4369 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
4370 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4371 The parameters are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4372 .sp 1
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4373 .PD 0
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4374 .RSs
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4375 .IPs xtile
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4376 number of tiles on the x axis (default: 5)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4377 .IPs ytile
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4378 number of tiles on the y axis (default: 5)
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4379 .IPs output
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4380 Render the tile when 'output' number of frames are reached, where 'output'
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4381 should be a number less than xtile * ytile.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4382 Missing tiles are left blank.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4383 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
4384 image every 2 seconds @ 25 fps.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4385 .IPs start
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4386 pixel at the start (x/\:y) (default: 2)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4387 .IPs delta
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4388 pixel between 2 tiles, (x/\:y) (default: 4)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4389 .RE
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4390 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4391 .
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4392 .TP
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4393 .B delogo[=x:y:w:h:t]
10813
f646e30ba119 spelling/wording fixes
diego
parents: 10812
diff changeset
4394 Suppresses a TV station logo by a simple interpolation of the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4395 surrounding pixels.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4396 Just set a rectangle covering the logo and watch it disappear (and
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4397 sometimes something even uglier appear \- your mileage may vary).
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4398 .PD 0
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4399 .RSs
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4400 .IPs x,y
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4401 Position of the top left corner of the logo.
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4402 .IPs w,h
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4403 Width and height of the cleared rectangle.
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4404 .IPs t
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4405 Thickness of the fuzzy edge of the rectangle (added to w and h).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4406 When set to -1, a green rectangle is drawn on the screen to
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4407 simplify finding the right x,y,w,h parameters.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4408 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4409 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4410 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4411 .TP
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4412 .B zrmjpeg[=options]
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4413 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
4414 output device.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4415 .RSs
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4416 .IPs maxheight=h|maxwidth=w
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4417 These options set the maximum width and height the zr card
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4418 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
4419 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4420 Use these options to set maxwidth and maxheight automatically to the
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4421 values known for card/\:mode combo.
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4422 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
4423 .IPs color|bw
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4424 Select color or black and white encoding.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4425 Black and white encoding is faster.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4426 Color is the default.
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4427 .IPs hdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4428 Horizontal decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4429 .IPs vdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4430 Vertical decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4431 .IPs quality=1-20
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4432 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
4433 .IPs fd|nofd
12028
91eb4f10a9ad spelling fixes
diego
parents: 12016
diff changeset
4434 By default, decimation is only performed if the Zoran hardware
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4435 can upscale the resulting MJPEG images to the original size.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4436 The option fd instructs the filter to always perform the requested
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4437 decimation (ugly).
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4438 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4439 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4440 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4441 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4442 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4443 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4444 .TP
11454
gabucino
parents: 11448
diff changeset
4445 .B \-audio-delay <0.0\-...>
gabucino
parents: 11448
diff changeset
4446 Sets the audio delay field in the header.
gabucino
parents: 11448
diff changeset
4447 Default is 0.0, negative values do not work.
gabucino
parents: 11448
diff changeset
4448 This does not delay the audio while encoding, but the player will see the
gabucino
parents: 11448
diff changeset
4449 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
4450 .
11454
gabucino
parents: 11448
diff changeset
4451 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4452 .B \-audio-density <1\-50>
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4453 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
4454 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4455 .I NOTE:
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4456 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
4457 .
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4458 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4459 .B \-audio-preload <0.0\-2.0>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4460 Sets up the audio buffering time interval (default: 0.5s).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4461 .
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4462 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4463 .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
4464 Stop encoding at the given time or byte position.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4465 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4466 .I NOTE:
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4467 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
4468 a frame boundary.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4469 .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
4470 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4471 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4472 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4473 .IPs "\-endpos 56"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4474 Encode only 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4475 .IPs "\-endpos 01:10:00"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4476 Encode only 1 hour 10 minutes.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4477 .IPs "\-endpos 100mb"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4478 Encode only 100 MBytes.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4479 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4480 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4481 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4482 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4483 .B \-ffourcc <fourcc>
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4484 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
4485 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4486 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4487 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4488 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4489 .IPs "\-ffourcc div3"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4490 Will have the output file contain 'div3' as video fourcc.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4491 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4492 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4493 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4494 .TP
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4495 .B \-force-avi-aspect <0.2\-3.0>
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4496 Override the aspect stored in the AVI OpenDML vprp header.
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4497 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
4498 .
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4499 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4500 .B \-info <option1:option2:...> (AVI only)
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4501 Specify the info header of the resulting AVI file.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4502 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4503 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
4504 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4505 .IPs help\
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4506 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
4507 .IPs name=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4508 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
4509 .IPs artist=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4510 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
4511 .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
4512 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
4513 .IPs subject=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4514 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
4515 .IPs copyright=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4516 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
4517 .IPs srcform=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4518 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
4519 .IPs comment=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4520 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
4521 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4522 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4523 .TP
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4524 .B \-noautoexpand
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4525 Do not automatically insert the expand filter into the MEncoder filter chain.
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4526 Useful to control at which point of the filter chain subtitles are rendered
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4527 when hardcoding subtitles onto a movie.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4528 .
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4529 .TP
12366
b6ff3941519b standard notation
diego
parents: 12363
diff changeset
4530 .B \-noodml (\-of avi only)
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4531 Do not write OpenDML index for AVI files >1GB.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4532 .
12363
5dac21977312 Allow user to disable writing of ODML index
ranma
parents: 12339
diff changeset
4533 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4534 .B \-noskip
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4535 Do not skip frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4536 .
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4537 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4538 .B \-o <filename>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4539 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
4540 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4541 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4542 .B \-oac <codec name>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4543 Encode with the given audio codec (no default set).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4544 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4545 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4546 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
4547 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4548 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4549 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4550 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4551 .IPs "\-oac copy"
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4552 no encoding, just streamcopy
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4553 .IPs "\-oac pcm"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4554 Encode to uncompressed PCM.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4555 .IPs "\-oac mp3lame"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4556 Encode to MP3 (using LAME).
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4557 .IPs "\-oac lavc"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4558 Encode with a libavcodec codec.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4559 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4560 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4561 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4562 .TP
8685
a90839057e15 -of is beta code
jonas
parents: 8682
diff changeset
4563 .B \-of <format> (BETA CODE!)
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4564 Encode to the specified container format (default: AVI).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4565 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4566 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4567 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
4568 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4569 .I EXAMPLE:
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4570 .PD 0
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4571 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4572 .IPs "\-of avi"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4573 Encode to AVI.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4574 .IPs "\-of mpeg"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4575 Encode to MPEG.
12016
b962aaad2940 rawvideo muxer patch by John Earl <jwe21@cam.ac.uk>
ranma
parents: 12013
diff changeset
4576 .IPs "\-of rawvideo"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4577 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
4578 .RE
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4579 .PD 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4580 .
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4581 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4582 .B \-ofps <fps>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4583 Specify a frames per second (fps) value for the output file,
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4584 which can be different from that of the source material.
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4585 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
4586 (29.97fps telecined MPEG) files.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4587 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4588 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4589 .B \-ovc <codec name>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4590 Encode with the given video codec (no default set).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4591 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4592 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4593 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
4594 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4595 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4596 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4597 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4598 .IPs "\-ovc copy"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4599 no encoding, just streamcopy
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4600 .IPs "\-ovc divx4"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4601 Encode to DivX4/\:DivX5.
11966
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
4602 .IPs "\-ovc raw"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4603 Encode to an arbitrary uncompressed format (use \-vf format to select).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4604 .IPs "\-ovc lavc"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4605 Encode with a libavcodec codec.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4606 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4607 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4608 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4609 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4610 .B \-passlogfile <filename>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4611 Dump first pass information to <filename> instead of the default divx2pass.log
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4612 in 2-pass encoding mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4613 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4614 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4615 .B \-skiplimit <value>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4616 Specify the maximum number of frames that may be skipped after
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4617 encoding one frame (\-noskiplimit for unlimited).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4618 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4619 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4620 .B \-vobsubout <basename>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4621 Specify the basename for the output .idx and .sub files.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4622 This turns off subtitle rendering in the encoded movie and diverts it to
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
4623 VOBsub subtitle files.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4624 .
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4625 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4626 .B \-vobsuboutid <langid>
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4627 Specify the language two letter code for the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4628 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
4629 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4630 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4631 .B \-vobsuboutindex <index>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4632 Specify the index of the subtitles in the output files (default: 0).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4633 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4634 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4635 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4636 .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
4637 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
4638 syntax:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4639 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4640 .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
4641 .B \-<codec>opts <option1[=value],option2,...>
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
4642 .
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4643 .PP
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
4644 Where <codec> may be: lavc, xvidenc, divx4, lame, x264enc
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4645 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4646 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4647 .SS divx4 (\-divx4opts)
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
4648 DivX4 is obsolete and only supported for completeness.
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
4649 For details about DivX4 options, read the source, most options are not
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
4650 described here.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4651 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4652 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4653 .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
4654 get help
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4655 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4656 .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
4657 .B br=<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
4658 specify bitrate
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4659 .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
4660 .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
4661 (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
4662 .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
4663 (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
4664 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4665 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4666 .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
4667 .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
4668 maximum keyframe interval (in frames)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4669 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4670 .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
4671 .B deinterlace
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4672 enable deinterlacing (avoid it, DivX4 is buggy)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4673 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4674 .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
4675 .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
4676 quality (1\-fastest, 5\-best)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4677 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4678 .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
4679 .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
4680 minimum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4681 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4682 .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
4683 .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
4684 maximum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4685 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4686 .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
4687 .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
4688 rate control period
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4689 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4690 .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
4691 .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
4692 rate control reaction period
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4693 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4694 .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
4695 .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
4696 rate control reaction ratio
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4697 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4698 .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
4699 .B crispness=<0\-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
4700 specify crispness/\:smoothness
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4701 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4702 .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
4703 .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
4704 With this you can encode 2pass DivX4 files.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4705 First encode with pass=1, then with the same parameters, encode with
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4706 pass=2.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4707 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4708 .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
4709 .B vbrpass=<0\-2>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4710 Override the pass argument and use XviD VBR Library instead of DivX4 VBR.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4711 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
4712 .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
4713 .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
4714 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
4715 .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
4716 Analysis (first) pass of two pass encoding.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4717 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
4718 .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
4719 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
4720 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4721 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4722 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4723 .SS lame (\-lameopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4724 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4725 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4726 .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
4727 get help
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4728 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4729 .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
4730 .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
4731 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
4732 .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
4733 .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
4734 .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
4735 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
4736 .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
4737 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
4738 .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
4739 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
4740 .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
4741 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
4742 .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
4743 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
4744 .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
4745 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4746 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4747 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4748 .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
4749 average bitrate
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4750 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4751 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4752 .B cbr\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4753 constant bitrate.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4754 Forces also CBR mode encoding on subsequent ABR presets modes
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4755 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4756 .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
4757 .B br=<0\-1024>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4758 specify bitrate in kBit (CBR and ABR only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4759 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4760 .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
4761 .B q=<0\-9>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4762 quality (0\-highest, 9\-lowest) (only for VBR)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4763 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4764 .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
4765 .B aq=<0\-9>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4766 algorithmic quality (0\-best/\:slowest, 9\-worst/\:fastest)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4767 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4768 .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
4769 .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
4770 compression ratio
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4771 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4772 .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
4773 .B vol=<0\-10>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4774 set audio input gain
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4775 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4776 .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
4777 .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
4778 (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
4779 .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
4780 .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
4781 .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
4782 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
4783 .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
4784 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
4785 .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
4786 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
4787 .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
4788 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
4789 .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
4790 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4791 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4792 .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
4793 .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
4794 .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
4795 .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
4796 .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
4797 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
4798 .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
4799 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
4800 .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
4801 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
4802 .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
4803 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4804 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4805 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4806 .B fast\ \ \
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4807 switch on faster encoding on subsequent VBR presets modes, slightly lower
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4808 quality and higher bitrates.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4809 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4810 .TP
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4811 .B highpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4812 Set a highpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4813 Frequencies below the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
4814 A value of -1 will disable filtering, a value of 0
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4815 will let LAME choose values automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4816 .
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4817 .TP
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4818 .B lowpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4819 Set a lowpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4820 Frequencies above the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
4821 A value of -1 will disable filtering, a value of 0
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4822 will let LAME choose values automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4823 .
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4824 .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
4825 .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
4826 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
4827 .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
4828 .IPs medium
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4829 VBR encoding, good quality, 150\-180 kbps bitrate 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
4830 .IPs standard
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4831 VBR encoding, high quality, 170\-210 kbps bitrate 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
4832 .IPs extreme
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4833 VBR encoding, very high quality, 200\-240 kbps bitrate 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
4834 .IPs insane
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4835 CBR encoding, highest preset quality, 320 kbps bitrate.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4836 .IPs <8\-320>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4837 ABR encoding at average given kbps bitrate.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4838 .RE
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4839 .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
4840 .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
4841 .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
4842 .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
4843 .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
4844 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4845 .IPs fast:preset=standard
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4846 for most people on most music and already quite high in quality.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4847 .IPs cbr:preset=192
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4848 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
4849 .IPs preset=172
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4850 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
4851 .IPs preset=extreme
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4852 for people with extremely good hearing and similar equipment.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4853 .IPs preset=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
4854 print additional options and informations on presets settings.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4855 .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
4856 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4857 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4858 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4859 .SS lavc (\-lavcopts)
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4860 Many lavc options are very specialized and tersely documented.
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4861 Read the source for full details.
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4862 .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
4863 .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
4864 .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
4865 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4866 .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
4867 .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
4868 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4869 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4870 .TP
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4871 .B acodec=<value>
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4872 Audio codec (default: mp2):
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4873 .PD 0
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4874 .RSs
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4875 .IPs mp2
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4876 MPEG Layer 2
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4877 .IPs mp3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4878 MPEG Layer 3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4879 .IPs ac3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4880 AC3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4881 .IPs adpcm_ima_wav
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4882 IMA Adaptive PCM (4bits per sample, 4:1 compression)
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4883 .RE
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4884 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4885 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4886 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4887 .B abitrate=<value>
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4888 Audio bitrate in kBit (default 224).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4889 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4890 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4891 .B atag=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4892 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
4893 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4894 .TP
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
4895 .B bit_exact
11938
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4896 Use only bit exact algorithms (except (i)dct).
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4897 Additionally bit_exact disables several optimizations and thus
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4898 should only be used for regression tests, which need binary
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4899 identical files even if the encoder version changes.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4900 This also suppresses the user_data header in MPEG-4 streams.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4901 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
4902 .
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
4903 .TP
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4904 .B threads=<1\-8>
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4905 Maximum number of threads to use (default: 1).
13208
a4601e903824 The threads lavc option may negatively affect motion estimation.
diego
parents: 13205
diff changeset
4906 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
4907 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4908 .
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4909 .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
4910 .B vcodec=<value>
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4911 Use 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
4912 .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
4913 .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
4914 .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
4915 Motion JPEG
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4916 .IPs ljpeg
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4917 Lossless JPEG
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4918 .IPs h263\
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4919 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
4920 .IPs h263p
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4921 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
4922 .IPs mpeg4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4923 DivX 4/\: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
4924 .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
4925 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
4926 .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
4927 MS MPEG4v2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4928 .IPs wmv1
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4929 Windows Media Video, version 1 (AKA WMV7)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4930 .IPs wmv2
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4931 Windows Media Video, version 2 (AKA WMV8)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4932 .IPs rv10
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4933 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
4934 .IPs mpeg1video
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4935 MPEG1 video
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4936 .IPs mpeg2video
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4937 MPEG2 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
4938 .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
4939 HuffYUV
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4940 .IPs asv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4941 ASUS Video v1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4942 .IPs asv2
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4943 ASUS Video v2
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4944 .IPs ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4945 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
4946 .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
4947 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4948 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4949 .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
4950 .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
4951 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
4952 .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
4953 .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
4954 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
4955 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
4956 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
4957 .IPs 2
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4958 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
4959 .IPs 3
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4960 Recommended for h263(p)/\:msmpeg4.
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4961 The reason for preferring 3 over 2 is that 2 could lead to overflows
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4962 (this will be fixed for h263(p) by changing the quantizer per MB in
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4963 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
4964 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4965 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4966 .TP
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4967 .B lmin=<0.01\-255.0>
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4968 Minimum lagrange multiplier for ratecontrol, you probably want it to be
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4969 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
4970 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4971 .
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4972 .TP
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4973 .B lmax=<0.01\-255.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4974 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
4975 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4976 .
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4977 .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
4978 .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
4979 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
4980 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
4981 1 is not recommended (see vqmin for details).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4982 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4983 .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
4984 .B vqmax=<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
4985 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
4986 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4987 .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
4988 .B mbqmin=<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
4989 minimum macroblock quantizer (pass\ 1/\:2) (default: 2)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4990 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4991 .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
4992 .B mbqmax=<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
4993 maximum macroblock quantizer (pass\ 1/\:2) (default: 31)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4994 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4995 .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
4996 .B vqdiff=<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
4997 maximum quantizer difference between I or P frames (pass\ 1/\:2) (default: 3)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4998 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4999 .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
5000 .B vmax_b_frames=<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
5001 maximum number of B frames between non B frames:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5002 .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
5003 .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
5004 .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
5005 no B frames (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
5006 .IPs 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
5007 sane range for MPEG4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5008 .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
5009 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5010 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5011 .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
5012 .B vme=<0\-5>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5013 motion estimation method.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5014 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5015 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5016 0\-3 currently ignores the amount of Bits spent,
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5017 so quality may be low.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5018 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
5019 .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
5020 .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
5021 .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
5022 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
5023 .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
5024 full (slow)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5025 .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
5026 log (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
5027 .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
5028 phods (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
5029 .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
5030 EPZS (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
5031 .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
5032 X1 (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
5033 .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
5034 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5035 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5036 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5037 .B me_range=<0\-9999>
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5038 motion estimation search range, 0 (default) means unlimited
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5039 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5040 .TP
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5041 .B mbd=<0\-2>
10503
diego
parents: 10498
diff changeset
5042 Macroblock decision algorithm (high quality mode), encode each macro
diego
parents: 10498
diff changeset
5043 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
5044 This is slow but results in better quality and file size.
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5045 .PD 0
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5046 .RSs
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5047 .IPs 0
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5048 use mbcmp (default)
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5049 .IPs 1
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5050 select the MB mode which needs the fewest bits (=vhq)
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5051 .IPs 2
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5052 select the MB mode which has the best rate distortion
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5053 .RE
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5054 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5055 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5056 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5057 .B vhq\ \ \ \
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5058 Same as mbd=1, kept for compatibility reasons.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5059 .
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5060 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5061 .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
5062 Allow 4 motion vectors per macroblock (slightly better quality).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5063 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5064 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5065 .B obmc\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5066 overlapped block motion compensation (H.263+)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5067 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5068 .TP
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5069 .B loop\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5070 loop filter (H.263+)
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5071 note, this is broken
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5072 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5073 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5074 .B inter_threshold <-1000\-1000>
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5075 Does absolutely nothing at the moment.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5076 .
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5077 .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
5078 .B keyint=<0\-300>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5079 maximum interval between keyframes in frames.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5080 Keyframes are needed for seeking as seeking is only possible to a keyframe but
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5081 keyframes need more space than other frames so larger numbers here mean
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5082 slightly smaller files, but less precise seeking, 0 means no keyframes.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5083 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
5084 decoder, encoder and luck.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5085 For a strict MPEG1/\:2/\:4 compliance this would have to be <=132.
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5086 (default: 250 or one keyframe every ten seconds in a 25fps movie)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5087 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5088 .TP
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5089 .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
5090 Threshold for scene change detection.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5091 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
5092 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
5093 -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
5094 no scene changes are detected (default 0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5095 .
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5096 .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
5097 .B vb_strategy=<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
5098 strategy to choose between I/\:P/\:B frames (pass\ 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
5099 .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
5100 .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
5101 always use the maximum number of B frames (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
5102 .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
5103 avoid B frames in high motion scenes (will cause bitrate misprediction)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5104 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5105 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5106 .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
5107 .B vpass=<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
5108 Activates internal two pass mode, only specify if you wish to use two pass
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5109 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
5110 .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
5111 .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
5112 .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
5113 first 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
5114 .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
5115 second 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
5116 .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
5117 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5118 .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
5119 .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
5120 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
5121 .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
5122 .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
5123 .RSs
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
5124 .IPs "pass 1"
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
5125 Saves statistics.
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
5126 .IPs "pass 2"
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5127 Encodes with an optimal Huffman table based upon statistics
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5128 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
5129 .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
5130 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5131 .
10380
8627ec205af8 moved -af options to the 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 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5133 .B aspect=<x/\:y>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5134 Store movie aspect internally, just like MPEG files.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5135 Much nicer solution than rescaling, because quality isn't decreased.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5136 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
5137 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
5138 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
5139 .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
5140 .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
5141 .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
5142 .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
5143 .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
5144 .PD 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5145 .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
5146 .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
5147 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5148 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5149 .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
5150 .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
5151 Same as the aspect option, but automatically computes aspect, taking
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5152 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
5153 filter chain.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5154 .
10380
8627ec205af8 moved -af options to the 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 .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
5156 .B vbitrate=<value>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5157 Specify bitrate (pass\ 1/\:2).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5158 Warning: 1kBit = 1000 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
5159 .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
5160 .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
5161 (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
5162 .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
5163 (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
5164 .IPs 800
8627ec205af8 moved -af options to the 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 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
5166 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5167 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5168 .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
5169 .B vratetol=<value>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5170 approximated filesize tolerance in kBit.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5171 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
5172 (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
5173 (default: 8000)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5174 .br
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5175 .I NOTE:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5176 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
5177 be problems if vrc_(min|max)rate is used.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5178 .
10380
8627ec205af8 moved -af options to the 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 .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
5180 .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
5181 maximum bitrate in kbit/\:sec (pass\ 1/\:2)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5182 .
10380
8627ec205af8 moved -af options to the 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 .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
5184 .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
5185 minimum bitrate in kbit/\:sec (pass\ 1/\:2)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5186 .
10380
8627ec205af8 moved -af options to the 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 .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
5188 .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
5189 buffer size in kbit (pass\ 1/\:2).
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5190 For MPEG1/\: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
5191 917 for SVCD and 1835 for DVD.
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
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5194 .B vrc_buf_aggressivity
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5195 currently useless
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5196 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5197 .TP
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5198 .B vrc_strategy
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5199 Dummy, reserved for future use.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5200 .
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5201 .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
5202 .B vb_qfactor=<-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
5203 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
5204 .
10380
8627ec205af8 moved -af options to the 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 .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
5206 .B vi_qfactor=<-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
5207 (pass\ 1/\:2) (default: 0.8)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5208 .
10380
8627ec205af8 moved -af options to the 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 .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
5210 .B vb_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
5211 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
5212 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5213 .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
5214 .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
5215 (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
5216 .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
5217 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
5218 .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
5219 I/\:B-Frame quantizer = P-Frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
8627ec205af8 moved -af options to the 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 .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
5221 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
5222 .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
5223 do normal ratecontrol (dont lock to next P frame 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
5224 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5225 .
10380
8627ec205af8 moved -af options to the 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 .TP
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
5227 .B \
10380
8627ec205af8 moved -af options to the 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 Tip: To do constant quantizer encoding with different quantizers for
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5229 I/\:P and B frames you can use:
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5230 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
5231 .
10380
8627ec205af8 moved -af options to the 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 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5233 .B vqblur=<0.0\-1.0> (pass 1)
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5234 Quantizer blur, larger values will average the quantizer more over
10380
8627ec205af8 moved -af options to the 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 time (slower change).
8627ec205af8 moved -af options to the 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 .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
5237 .IPs 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
5238 qblur 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
5239 .IPs 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
5240 (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
5241 .IPs 1.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
5242 average the quantizer over all previous frames
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5243 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5244 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5245 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5246 .B vqblur=<0.0\-99.0> (pass 2)
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5247 Quantizer gaussian blur, larger values will average the quantizer more
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5248 over time (slower change) (default: 0.5).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5249 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5250 .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
5251 .B vqcomp=<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
5252 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
5253 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5254 .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
5255 .B vrc_eq=<equation>
8627ec205af8 moved -af options to the 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 main ratecontrol equation (pass\ 1/\:2):
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5257 .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
5258 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5259 .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
5260 constant bitrate
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5261 .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
5262 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
5263 .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
5264 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
5265 .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
5266 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
5267 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5268 .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
5269 .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
5270 infix operators: +,-,*,/,^
8627ec205af8 moved -af options to the 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 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5272 .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
5273 .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
5274 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
5275 .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
5276 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5277 .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
5278 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
5279 .IPs iTex,pTex
8627ec205af8 moved -af options to the 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 intra, non intra 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
5281 .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
5282 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
5283 .IPs avgIITex
8627ec205af8 moved -af options to the 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 average intra texture complexity in I frames
8627ec205af8 moved -af options to the 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 .IPs avgPITex
8627ec205af8 moved -af options to the 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 average intra texture complexity in P frames
8627ec205af8 moved -af options to the 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 avgPPTex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5288 average non intra texture complexity in P frames
8627ec205af8 moved -af options to the 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 avgBPTex
8627ec205af8 moved -af options to the 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 average non intra texture complexity in B frames
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5291 .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
5292 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
5293 .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
5294 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
5295 .IPs iCount
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5296 number of intra macroblocks / number of macroblocks
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5297 .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
5298 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
5299 .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
5300 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
5301 .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
5302 qcomp from the command line
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5303 .IPs "isI, isP, isB"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5304 is 1 if picture type is I/\:P/\:B else 0
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5305 .IPs Pi,E\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5306 see your favorite math book
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5307 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5308 .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
5309 .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
5310 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
5311 .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
5312 .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
5313 .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
5314 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
5315 .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
5316 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
5317 .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
5318 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
5319 .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
5320 is 1 if a==b, 0 otherwise
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5321 .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
5322 .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
5323 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5324 .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
5325 .B vrc_override=<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
5326 User specified quality for specific parts (ending, credits, ..) (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
5327 The options are <start-frame>, <end-frame>, <quality>[/\:<start-frame>,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5328 <end-frame>, <quality>[/\:...]]:
10380
8627ec205af8 moved -af options to the 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 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5330 .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
5331 quantizer
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5332 .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
5333 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
5334 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5335 .
10380
8627ec205af8 moved -af options to the 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 .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
5337 .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
5338 initial complexity (pass\ 1)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5339 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5340 .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
5341 .B vqsquish=<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
5342 specify how to keep the quantizer between qmin and qmax (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
5343 .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
5344 .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
5345 .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
5346 use clipping
8627ec205af8 moved -af options to the 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 .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
5348 use a nice differentiable function (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
5349 .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
5350 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5351 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5352 .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
5353 .B vlelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5354 Sets single coefficient elimination threshold for luminance.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5355 Negative values will also consider the dc coefficient (should be at least -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
5356 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
5357 .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
5358 .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
5359 .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
5360 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
5361 .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
5362 (JVT recommendation)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5363 .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
5364 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5365 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5366 .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
5367 .B vcelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5368 Sets single coefficient elimination threshold for chrominance.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5369 Negative values will also consider the dc coefficient (should be at least -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
5370 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
5371 .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
5372 .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
5373 .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
5374 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
5375 .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
5376 (JVT recommendation)
8627ec205af8 moved -af options to the 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 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5378 .
10380
8627ec205af8 moved -af options to the 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 .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
5380 .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
5381 strict standard compliance
8627ec205af8 moved -af options to the 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 .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
5383 .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
5384 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
5385 .IPs 1
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5386 only recommended if you want to feed the output into the MPEG4 reference
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5387 decoder
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5388 .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
5389 allows non-standard YV12 huffyuv encoding (20% smaller files, but cannot be
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5390 played by the official huffyuv 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
5391 .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
5392 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5393 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5394 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5395 .B vdpart\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5396 data partitioning.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5397 Adds 2 Bytes per video packet, improves error-resistance when transferring over
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5398 unreliable channels (eg.\& streaming over the internet)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5399 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
5400 .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
5401 .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
5402 .IPs "1. MVs"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5403 (movement)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5404 .IPs "2. DC coefficients"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5405 (low res picture)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5406 .IPs "3. AC coefficients"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5407 (details)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5408 .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
5409 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5410 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5411 .TP
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
5412 .B \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5413 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
5414 the AC and the 1. & 2. partition.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5415 (MV&DC) are far smaller than the 3. partition (AC) meaning that errors
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5416 will hit the AC partition much more often than the MV&DC partitions.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5417 Thus, the picture will look better with partitioning than without,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5418 as without partitioning an error will trash AC/\:DC/\:MV equally.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5419 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5420 .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
5421 .B vpsize=<0\-10000>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5422 video packet size, improves error-resistance (also see vdpart):
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5423 .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
5424 .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
5425 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
5426 .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
5427 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
5428 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5429 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5430 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5431 .B ss\ \ \ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5432 slice structured mode for H.263+
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5433 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5434 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5435 .B gray\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5436 grayscale only encoding (faster)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5437 .
10380
8627ec205af8 moved -af options to the 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 .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
5439 .B vfdct=<0\-10>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5440 dct algorithm:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5441 .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
5442 .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
5443 .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
5444 automatically select a good one (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
5445 .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
5446 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
5447 .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
5448 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
5449 .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
5450 mmx
8627ec205af8 moved -af options to the 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 .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
5452 mlib
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5453 .IPs 5
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5454 altivec
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5455 .IPs 6
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5456 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
5457 .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
5458 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5459 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5460 .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
5461 .B idct=<0\-99>
8627ec205af8 moved -af options to the 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 idct algorithm.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5463 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5464 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5465 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
5466 .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
5467 .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
5468 .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
5469 automatically select a good one (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
5470 .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
5471 jpeg reference 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
5472 .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
5473 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
5474 .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
5475 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
5476 .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
5477 libmpeg2mmx (inaccurate, DON'T USE for encoding with keyint >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
5478 .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
5479 ps2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5480 .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
5481 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
5482 .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
5483 arm
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5484 .IPs 8
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5485 altivec
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5486 .IPs 9
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5487 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
5488 .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
5489 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5490 .
10380
8627ec205af8 moved -af options to the 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 .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
5492 .B lumi_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5493 luminance masking
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5494 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5495 .I WARNING:
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5496 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5497 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5498 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5499 Large values might look good on some monitors but may look horrible
10380
8627ec205af8 moved -af options to the 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 on other monitors:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5501 .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
5502 .IPs 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
5503 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
5504 .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
5505 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
5506 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5507 .
10380
8627ec205af8 moved -af options to the 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 .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
5509 .B dark_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5510 darkness masking
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5511 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5512 .I WARNING:
13058
29d8052f48f7 consistency fix, same sentence should be changed to same
wight
parents: 13053
diff changeset
5513 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5514 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5515 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5516 Large values might look good on some monitors but may look horrible
10380
8627ec205af8 moved -af options to the 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 on other monitors / TV / TFT:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5518 .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
5519 .IPs 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
5520 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
5521 .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
5522 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
5523 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5524 .
10380
8627ec205af8 moved -af options to the 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 .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
5526 .B tcplx_mask=<0.0\-1.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
5527 temporal complexity masking (default: 0.0 (disabled))
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5528 .
10380
8627ec205af8 moved -af options to the 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 .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
5530 .B scplx_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5531 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
5532 Larger values help against blockiness, if no deblocking filter is used for
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5533 decoding.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5534 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5535 .I HINT:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5536 Crop any black borders completely as they will reduce the quality
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5537 of the macroblocks (also applies without scplx_mask).
10380
8627ec205af8 moved -af options to the 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 .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
5539 .IPs 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
5540 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
5541 .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
5542 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
5543 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5544 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5545 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5546 .B p_mask=<0.0\-1.0>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5547 inter MB masking (default: 0.0 (disabled))
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5548 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5549 .TP
11430
nicolas
parents: 11424
diff changeset
5550 .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
5551 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
5552 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
5553 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
5554 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
5555 average.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5556 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5557 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5558 .B ildct\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5559 use interlaced dct
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5560 .
10380
8627ec205af8 moved -af options to the 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 .TP
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5562 .B ilme\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
5563 Use interlaced motion estimation (mutually exclusive with qpel).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5564 .
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5565 .TP
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5566 .B alt\ \ \ \
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5567 use alternative scantable
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5568 .
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5569 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5570 .B top=<-1\-1>\ \ \
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5571 .RSs
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5572 .IPs -1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5573 automatic
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5574 .IPs 0
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5575 bottom field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5576 .IPs 1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5577 top field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5578 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5579 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5580 .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
5581 .B format=<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
5582 .RSs
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5583 .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
5584 default
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5585 .IPs 444P
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5586 for ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5587 .IPs 422P
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5588 for huffyuv, lossless jpeg and ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5589 .IPs 411P,YVU9
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5590 for lossless jpeg and ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5591 .IPs BGR32
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5592 for lossless jpeg and ffv1
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5593 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5594 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5595 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5596 .B pred\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5597 (for 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
5598 .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
5599 .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
5600 .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
5601 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
5602 .IPs 1
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5603 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
5604 .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
5605 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
5606 .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
5607 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5608 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5609 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5610 .B pred\ \ \
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5611 (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
5612 .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
5613 .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
5614 .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
5615 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
5616 .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
5617 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
5618 .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
5619 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
5620 .IPs 3
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5621 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
5622 .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
5623 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
5624 .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
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
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5628 .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
5629 (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
5630 .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
5631 .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
5632 .IPs 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
5633 vlc coding (golomb rice)
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
5634 .IPs 1
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
5635 arithmetic coding (cabac)
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
5636 .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
5637 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5638 .
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
5639 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5640 .B context
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5641 (for ffv1)
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5642 .PD 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5643 .RSs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5644 .IPs 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5645 small context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5646 .IPs 1
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5647 large context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5648 .RE
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5649 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5650 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5651 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5652 .B qpel\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
5653 Use quarter pel motion compensation (mutually exclusive with ilme).
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
5654 Hint: This seems only useful for high bitrate encodings.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5655 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5656 .TP
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5657 .B ildctcmp=<0\-2000>
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5658 comparison function for interlaced dct decision
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5659 .
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5660 .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
5661 .B precmp=<0\-2000>
8627ec205af8 moved -af options to the 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 comparison function for motion estimation pre pass
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5663 .
10380
8627ec205af8 moved -af options to the 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 .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
5665 .B cmp=<0\-2000>
8627ec205af8 moved -af options to the 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 comparison function for full pel motion estimation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5667 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5668 .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
5669 .B subcmp=<0\-2000>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5670 comparison function for sub pel motion estimation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5671 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5672 .TP
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5673 .B mbcmp=<0\-2000>
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5674 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
5675 .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
5676 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5677 .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
5678 sum of absolute differences, fast (default)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5679 .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
5680 sum of squared errors
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5681 .IPs "2 (SATD)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5682 sum of absolute hadamard transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5683 .IPs "3 (DCT)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5684 sum of absolute dct transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5685 .IPs "4 (PSNR)"
10380
8627ec205af8 moved -af options to the 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 sum of the squared quantization errors (don't use, low quality)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5687 .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
5688 number of bits needed for the block
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5689 .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
5690 rate distortion optimal, slow
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5691 .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
5692 0
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5693 .IPs "8 (VSAD)"
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5694 sum of absolute vertical differences
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5695 .IPs "9 (VSSE)"
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5696 sum of squared vertical differences
12593
michael
parents: 12581
diff changeset
5697 .IPs "10 (NSSE)"
michael
parents: 12581
diff changeset
5698 noise preserving sum of squared differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5699 .IPs +256\
10380
8627ec205af8 moved -af options to the 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 use chroma too, doesn't work (correctly) with B frames currently
8627ec205af8 moved -af options to the 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 .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
5702 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5703 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5704 .TP
12607
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
5705 .B nssew=<0\-100>
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
5706 NSSE weight, larger weights will result in more noise,
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
5707 with 0 NSSE is identical to SSE.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5708 .
12593
michael
parents: 12581
diff changeset
5709 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5710 .B predia=<-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
5711 Diamond type and size for motion estimation pre pass
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5712 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5713 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5714 .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
5715 Diamond type & size for motion estimation.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5716 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5717 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5718 The sizes of the normal diamonds and shape adaptive ones don't have
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5719 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
5720 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5721 .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
5722 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
5723 .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
5724 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
5725 .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
5726 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
5727 .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
5728 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
5729 .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
5730 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5731 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
5732 000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5733 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
5734 .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
5735 .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
5736 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
5737 .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
5738 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5739 0
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5740 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
5741 00000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5742 000
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5743 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
5744 .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
5745 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5746 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5747 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5748 .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
5749 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
5750 This will find the optimal encoding for each 8x8 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
5751 Trellis searched quantization is quite simple a optimal quantization in the PSNR
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5752 vs bitrate sense (assuming that there would be no rounding errors introduced
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5753 by the IDCT, which is obviously not the case) it simply finds a block for
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5754 the minimum of error and lambda*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
5755 .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
5756 .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
5757 .IPs lambda
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5758 quantizer parameter (QP) dependant constant
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
5759 .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
5760 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
5761 .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
5762 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
5763 .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
5764 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5765 .
10380
8627ec205af8 moved -af options to the 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 .TP
10963
michael
parents: 10917
diff changeset
5767 .B cbp\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5768 Rate distorted optimal coded block pattern.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5769 Will select the coded block pattern which minimizes distortion + lambda*rate.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5770 This can only be used together with trellis quantization.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5771 .
10963
michael
parents: 10917
diff changeset
5772 .TP
10974
michael
parents: 10969
diff changeset
5773 .B mv0\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5774 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
5775 This has no effect if mbd=0.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5776 .
10974
michael
parents: 10969
diff changeset
5777 .TP
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5778 .B qprd (mbd=2 only)
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5779 rate distorted optimal quantizer parameter (QP) for the given
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5780 lambda of each macroblock
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5781 .
11446
michael
parents: 11443
diff changeset
5782 .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
5783 .B last_pred=<0\-99>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5784 Amount of motion predictors from the previous frame
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5785 .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
5786 .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
5787 .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
5788 (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
5789 .IPs a
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5790 will use 2a+1 x 2a+1 macroblock square of motion vector predictors from 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
5791 previous frame
8627ec205af8 moved -af options to the 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 .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
5793 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5794 .
10380
8627ec205af8 moved -af options to the 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 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5796 .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
5797 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
5798 .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
5799 .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
5800 .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
5801 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
5802 .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
5803 only after I frames (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
5804 .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
5805 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
5806 .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
5807 .PD 1
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 subq=<1\-8>
13241
9aac2cd8bc53 better documentation of not obvious subq default setting
gpoirier
parents: 13219
diff changeset
5811 subpel refinement quality (for qpel) (default: 8 (high quality)).
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5812 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5813 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5814 This has a significant effect on speed.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5815 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5816 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5817 .B psnr\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
5818 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
5819 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
5820 Returned values are in dB (decibel), the higher the better.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5821 .
10380
8627ec205af8 moved -af options to the 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 .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
5823 .B mpeg_quant
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5824 Use MPEG quantizers instead of H.263.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5825 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5826 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5827 .B aic\ \ \ \
10966
a7c027115939 latest lavc uses the AIC flag also to turn mpeg4 ac prediction on/off
michael
parents: 10963
diff changeset
5828 ac prediction (=advanced intra prediction for H.263+)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5829 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5830 .I NOTE:
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5831 vqmin should be 8 or larger for AIC H.263+.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5832 .
10380
8627ec205af8 moved -af options to the 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 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5834 .B aiv\ \ \ \
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5835 alternatice inter vlc for H.263+
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5836 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5837 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5838 .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
5839 unlimited MVs (H.263+ 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
5840 Allow encoding of abritarily long MVs.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5841 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5842 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5843 .B ibias=<-256\-256>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5844 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96,
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5845 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
5846 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5847 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5848 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
5849 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
5850 .
10380
8627ec205af8 moved -af options to the 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 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5852 .B pbias=<-256\-256>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5853 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0,
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5854 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
5855 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5856 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5857 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
5858 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
5859 .br
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5860 .I HINT:
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
5861 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
5862 .
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5863 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5864 .B nr=<0\-100000>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5865 noise reduction, 0 is disabled
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5866 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5867 .TP
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5868 .B qns=<0\-3>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5869 Quantizer noise shaping, reduces ringing artefacts, larger values are slower
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5870 but may not result in better quality.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5871 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
5872 the trellis quantization (optimal for constant weight) will be used as
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5873 startpoint for the iterative search.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5874 .PD 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5875 .RSs
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5876 .IPs 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5877 disabled (default)
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5878 .IPs 1
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5879 only lower the absolute value of coefficients
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5880 .IPs 2
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5881 only change coefficients before the last non zero coefficient + 1
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5882 .IPs 3
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5883 try all
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5884 .RE
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5885 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5886 .
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5887 .TP
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5888 .B inter_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5889 Use custom inter matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5890 It needs a comma separated string of 64 integers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5891 .
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5892 .TP
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5893 .B intra_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5894 Use custom intra matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5895 It needs a comma separated string of 64 integers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5896 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5897 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5898 .B vqmod_amp
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5899 experimental quantizer modulation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5900 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5901 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5902 .B vqmod_freq
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5903 experimental quantizer modulation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5904 .
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5905 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5906 .B dc\ \ \ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5907 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
5908 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
5909 .
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5910 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5911 .B cgop\ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5912 Close all GOPs.
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5913 Currently it doesn't work (yet).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5914 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5915 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5916 .SS nuv (\-nuvopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5917 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5918 Nuppel video is based on rtjpeg and lzo.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5919 By default frames are first encoded with rtjpeg and then compressed with lzo.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5920 But both passes can be enabled or not.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5921 So you can in fact output raw i420, lzo compressed i420, rtjpeg, or the
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5922 default lzo compressed rtjpeg.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5923 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5924 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5925 The nuvrec documentation contains some advice and examples about the
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5926 settings to use for the most common TV encodings.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5927 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5928 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5929 .B c=<0\-20>
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5930 chrominance threshold
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5931 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5932 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5933 .B l=<0\-20>
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5934 luminance threshold
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5935 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5936 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
5937 .B nolzo \
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5938 Disable the lzo compression.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5939 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5940 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5941 .B q=<3\-255>
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5942 Set the quality level.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5943 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5944 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
5945 .B raw \ \ \
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5946 Disable rtjpeg encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5947 .
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5948 .TP
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5949 .B rtjpeg\
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5950 Enable rtjpeg encoding.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5951 .
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
5952 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5953 .SS xvidenc (\-xvidencopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5954 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5955 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
5956 2pass.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5957 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5958 .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
5959 .B pass=<1|2>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5960 Specify the pass in 2pass mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5961 .
10380
8627ec205af8 moved -af options to the 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 .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
5963 .B bitrate=<value>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5964 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
5965 if >16000.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5966 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
5967 (in kbytes) of the video and compute the associated bitrate automagically.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5968 (CBR or 2pass mode, default: 687 kbits/\:s)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5969 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5970 .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
5971 .B fixed_quant=<1\-31>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5972 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
5973 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5974 .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
5975 .B me_quality=<0\-6>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5976 This option controls the motion estimation subsystem.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5977 The higher the value, the more precise the estimation should be.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5978 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
5979 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
5980 you need realtime encoding.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5981 (default: 6)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5982 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5983 .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
5984 .B interlacing
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5985 Encode the fields of interlaced video material.
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5986 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
5987 .br
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
5988 .I NOTE:
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5989 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
5990 which you can activate with -vf scale=<width>:<height>:1.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5991 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5992 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5993 .B 4mv\ \ \ \
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5994 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
5995 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
5996 .br
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5997 .I WARNING:
13257
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
5998 This option is deprecated in XviD-1.0.x, as all is now taken care of
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
5999 by the me_quality option.
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6000 When me_quality > 4, 4mv is activated.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6001 .
10380
8627ec205af8 moved -af options to the 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 .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
6003 .B rc_reaction_delay_factor=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6004 This parameter controls the delay in frames before the CBR rate controller
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6005 will react to bitrate changes and will try to compensate the change to obtain
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6006 a constant bitrate over an averaging range of frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6007 .
10380
8627ec205af8 moved -af options to the 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 .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
6009 .B rc_averaging_period=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6010 Real CBR is hard to achieve.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6011 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
6012 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
6013 amount of bits (minus a small variation).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6014 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
6015 bitrate and tries to achieve CBR.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6016 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6017 .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
6018 .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
6019 size of the rate control buffer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6020 .
10380
8627ec205af8 moved -af options to the 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 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6022 .B quant_range=<1\-31>\-<1\-31>[/\:<1\-31>\-<1\-31>]
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6023 CBR mode: min & max quantizer for all frames (default: 2\-31)
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6024 .br
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6025 2pass mode: min & max quantizer for I/\:P frames (default: 2\-31/\:2\-31)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6026 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6027 .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
6028 .B min_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6029 minimum interval between keyframes (default: 0, 2pass only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6030 .
10380
8627ec205af8 moved -af options to the 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 .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
6032 .B max_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6033 maximum interval between keyframes (default: 10*fps)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6034 .
10380
8627ec205af8 moved -af options to the 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 .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
6036 .B mpeg_quant
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6037 Use MPEG quantizers instead of H.263.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6038 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
6039 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
6040 When using custom matrices, MPEG must be used.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6041 .
10380
8627ec205af8 moved -af options to the 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 .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
6043 .B mod_quant
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6044 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6045 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6046 .I WARNING:
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6047 This will generate an illegal bitstream, and most likely not be decodable
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6048 by any MPEG4 decoder besides libavcodec or XviD.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6049 (2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6050 .
10380
8627ec205af8 moved -af options to the 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 .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
6052 .B greyscale
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6053 Make XviD discard chroma planes so the encoded video is greyscale only.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6054 Note that this does not speed up encoding, it just prevents chroma data
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6055 from being written in the last stage of encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6056 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6057 .TP
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
6058 .B debug\ \
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6059 Save per-frame statistics in ./xvid.dbg.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6060 This is NOT the 2pass control file.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6061 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6062 .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
6063 .B keyframe_boost=<0\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6064 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
6065 thus improving keyframe quality.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6066 (default: 0, 2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6067 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6068 .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
6069 .B kfthreshold=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6070 (default: 10, 2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6071 .
10380
8627ec205af8 moved -af options to the 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 .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
6073 .B kfreduction=<0\-100>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6074 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
6075 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
6076 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
6077 kfreduction determines the bitrate reduction they get.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6078 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
6079 (default: 30, 2pass mode only)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
6080 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6081 .
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6082 .PP
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
6083 .sp 1
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
6084 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
6085 releases of XviD 1.0.x (api4).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6086 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6087 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6088 .B packed\
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6089 Create a bitstream which can be decoded delay-free.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
6090 .br
9818
rguyom
parents: 9809
diff changeset
6091 .I WARNING:
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6092 This will generate an illegal bitstream, and WILL NOT be
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6093 decodable by ISO-MPEG4 decoders except DivX/\:libavcodec/\:XviD.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
6094 .br
9818
rguyom
parents: 9809
diff changeset
6095 .I WARNING:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6096 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
6097 autodetection of some decoders might be confused.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6098 .
10380
8627ec205af8 moved -af options to the 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 .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
6100 .B divx5bvop
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6101 generate DivX5 compatible B-frames (default: on)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6102 .
10380
8627ec205af8 moved -af options to the 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 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6104 .B qpel\ \ \
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6105 MPEG4 uses a half pixel precision for its motion search by default.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6106 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
6107 pixel precision.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6108 This option usually results in a sharper image.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6109 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
6110 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
6111 quality at a fixed bitrate.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6112 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
6113 is worth activating.
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
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6116 .B gmc\ \ \ \
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6117 Enable Global Motion Compensation, which makes XviD generate special
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6118 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
6119 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
6120 dependent on the source material.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6121 .
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6122 .TP
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6123 .B trellis
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6124 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
6125 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
6126 compressible by the entropy encoder.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6127 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
6128 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
6129 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
6130 .
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6131 .TP
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6132 .B cartoon
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6133 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
6134 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
6135 frame types and motion vectors for flat looking cartoons.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6136 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6137 .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
6138 .B chroma_me
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6139 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
6140 find the best motion vector.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6141 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
6142 better vectors.
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6143 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
6144 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6145 .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
6146 .B chroma_opt
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6147 Enable a chroma optimizer prefilter.
13053
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6148 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
6149 stepped-stairs effect on edges.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6150 It will improve quality at the cost of encoding speed.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6151 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
6152 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
6153 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
6154 encoding in greyscale.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6155 .
10380
8627ec205af8 moved -af options to the 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 .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
6157 .B reduced
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6158 Enable encoding reduced-resolution frames.
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6159 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6160 .I WARNING:
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6161 The bitstream created is outside any MPEG-4 profile!
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6162 This means it most likely won't be decodable by anything except XviD.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6163 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6164 .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
6165 .B max_bframes=<0\-4>
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6166 maximum number of B frames to put between I/\:P frames (default: 0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6167 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6168 .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
6169 .B bquant_ratio=<0\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6170 quantizer ratio between B and non B frames, 150=1.50 (default: 150)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6171 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6172 .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
6173 .B bquant_offset=<-1000\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6174 quantizer offset between B and non B frames, 100=1.00 (default: 100)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6175 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6176 .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
6177 .B bf_threshold=<-255\-255>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6178 Sometimes B frames do not look good, and introduce artifacts when most of
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6179 the frame is static and some small zones have high motion (in a static
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6180 scene with a man talking, his mouth will probably look bad if what is
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6181 surrounding the man and his mouth is completly static).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6182 This setting allows you to favorize or not, the use of B frames.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6183 The higher the value, the higher the probability of B frames being used.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6184 (default: 0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6185 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6186 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6187 .B hq_ac\ \
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6188 Activates High Quality AC coefficient prediction from neighbor blocks.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6189 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6190 .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
6191 .B vhq=<0\-4>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6192 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
6193 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
6194 reference frame and the encoded frame.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6195 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
6196 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
6197 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
6198 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
6199 .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
6200 .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
6201 .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
6202 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
6203 .IPs 1
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6204 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
6205 .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
6206 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
6207 .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
6208 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
6209 .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
6210 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
6211 .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
6212 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6213 .
10380
8627ec205af8 moved -af options to the 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 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6215 .B aspect=<x/\:y | f (float value)>
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6216 Store movie aspect internally, just like MPEG files.
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6217 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
6218 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
6219 will display them with the wrong aspect.
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6220 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
6221 .
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6222 .TP
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6223 .B autoaspect
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6224 Same as the aspect option, but automatically computes aspect, taking
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6225 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
6226 filter chain.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6227 .
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6228 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6229 .B psnr\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6230 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
6231 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
6232 the current directory.
9809
508dc4231269 Actually do something useful with XVID_GLOBAL_EXTRASTATS / XVID_EXTRASTATS.
rguyom
parents: 9808
diff changeset
6233 Returned values are in dB (decibel), the higher the better.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6234 .
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6235 .
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
6236 .SS x264enc (\-x264encopts)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6237 .
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
6238 .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
6239 .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
6240 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
6241 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
6242 .
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
6243 .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
6244 .B iframe=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6245 I frame frequency (default: 60)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6246 .
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
6247 .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
6248 .B frameref=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6249 Number of previous frames used as predictors in a P-frame (default: 1).
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
6250 .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
6251 .I NOTE:
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6252 As of x264 r38 this feature is not implemented yet.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6253 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
6254 .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
6255 .B idrframe=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6256 Each <value> I-Frames are IDR-Frames (default: 2).
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
6257 In H.264, I-Frames do not necessarily bound a closed GOP because it 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
6258 allowable for a P-frame to be predicted from more frames than just the one
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6259 frame before it (also see frameref).
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6260 Therefore, I-frames are not necessarily seekable.
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6261 IDR-Frames restrict subsequent P-frames from referring to any frame
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6262 prior to the IDR-Frame.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6263 .
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
6264 .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
6265 .B bframe=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6266 number of B-Frames between I- and P-Frames (default: 0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6267 .
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
6268 .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
6269 .B deblock=<0|1>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6270 Use deblocking filter (default: on).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6271 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
6272 .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
6273 .B deblockalpha=<-6-6>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6274 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
6275 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
6276 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
6277 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
6278 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
6279 edge being filtered.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6280 A positive value reduces blocking artifacts more, but will also smear details.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6281 .
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
6282 .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
6283 .B deblockbeta=<-6-6>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6284 Beta parameter of deblocking filter (default: 0).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6285 Affects the maximum allowed gradient within two adjacent blocks.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6286 .
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
6287 .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
6288 .B cabac
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6289 Use CABAC (Context-Adaptive Binary Arithmetic Coding).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6290 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
6291 .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
6292 .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
6293 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
6294 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
6295 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
6296 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
6297 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
6298 .RSs
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6299 -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
6300 .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
6301 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
6302 .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
6303 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
6304 .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
6305 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
6306 .REss
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6307 .
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
6308 .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
6309 .B qp_constant=<2-51>
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
6310 This selects the quantizer to use.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6311 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
6312 Lower values result in better fidelity, but higher bitrates.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6313 Note that quantization in H.264 works differently from MPEG[124].
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6314 H.264's quantizer parameter (QP) is on a logarithmic scale.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6315 As an example, the bitrate difference between QP=20 and QP=40
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6316 is about a factor of 10.
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6317 Useful quantizers in H.264 tend to be very large compared to MPEG[124].
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
6318 .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
6319 .I NOTE:
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6320 This option takes effect even if you specify a CBR encode.
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6321 In such a case, the first encoded frame will use the quantization factor 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
6322 specified, but in later frames, the ratecontrol decides what quants to use.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6323 .
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
6324 .TP
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6325 .B qp_min=<2-51> (CBR only)
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6326 Minimum quantizer, 20-40 seems to be a useful range (default: 2).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6327 .
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6328 .TP
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6329 .B qp_max=<2-51> (CBR only)
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6330 Maximum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6331 .
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
6332 .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
6333 .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
6334 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
6335 frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6336 .
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
6337 .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
6338 .B rc_buffer_size=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6339 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
6340 specified)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6341 .
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
6342 .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
6343 .B rc_init_buffer=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6344 Set the initial ratecontrol buffer (default: 1/4 of rc_buffer_size)
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6345 .
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6346 .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
6347 .B rc_sens=<0-100>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6348 ratecontrol sensitivity (default: 100)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6349 .
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
6350 .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
6351 .B ip_factor=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6352 quantizer factor between I amd P frames (default: 2.0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6353 .
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
6354 .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
6355 .B pb_factor=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6356 quantizer factor between P and B frames (default: 2.0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6357 .
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
6358 .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
6359 .B pass=<1|2>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6360 Enable 2-pass mode.
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6361 The first pass saves statistics.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6362 .
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
6363 .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
6364 .B qcompress=<0-1>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6365 quantizer compression (default: 0.6).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6366 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
6367 bitrate more constant, while a higher value makes the quantization parameter
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6368 more constant.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6369 .
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
6370 .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
6371 .B qblur=<0-1>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6372 Temporal blur of the quantization parameter (default: 0.5).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6373 Lower values allow the quantizer value to jump around more,
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6374 higher values force it to vary more smoothly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6375 .
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
6376 .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
6377 .B fullinter
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6378 Use all available interframe analysis methods (i4x4, psub8x8, psub16x16)
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6379 (default: 4x4, psub16x16).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6380 .
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
6381 .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
6382 .B log=<-1-3>
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
6383 Adjust the amount of logging info printed to the screen.
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
6384 .RSs
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
6385 -1: none
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
6386 .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
6387 0: errors (for debugging x264)
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
6388 .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
6389 1: warnings
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
6390 .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
6391 2: PSNR and other analysis stats when the encode finishes (default)
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
6392 .br
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6393 3: PSNR, QP, frametype, size, and other stats for every frame
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
6394 .REss
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6395 .
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
6396 .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
6397 .B psnr
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
6398 Print signal-to-noise ratio statistics.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6399 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6400 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6401 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6402 .\" Files
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6403 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6404 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6405 .SH FILES
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6406 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6407 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6408 /usr/\:/local\:etc/\:mplayer/\:mplayer.conf
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6409 system-wide settings
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6410 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6411 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6412 ~/.mplayer/\:config
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6413 user settings
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6414 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6415 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6416 ~/.mplayer/\:input.conf
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6417 input bindings (see '\-input keylist' for the full list)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6418 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6419 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6420 ~/.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
6421 GUI configuration file
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6422 .
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
6423 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6424 ~/.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
6425 GUI playlist
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6426 .
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
6427 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6428 ~/.mplayer/\:font/
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6429 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
6430 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
6431 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6432 ~/.mplayer/\:DVDkeys/
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
6433 cached CSS keys
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6434 .
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
6435 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6436 Assuming that /path/\:to/\:movie.avi is played, MPlayer searches for sub files
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6437 in this order:
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
6438 .RS
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6439 /path/\:to/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
6440 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6441 ~/.mplayer/\:sub/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
6442 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6443 ~/.mplayer/\:default.sub
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
6444 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
6445 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6446 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6447 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6448 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6449 .\" Examples
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6450 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6451 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6452 .SH EXAMPLES
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6453 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6454 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6455 .B quickstart DVD playing:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
6456 mplayer dvd://1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6457 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6458 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6459 .B Play in Japanese with English subtitles:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
6460 mplayer dvd://1 \-alang ja \-slang en
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6461 .
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
6462 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6463 .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
6464 mplayer dvd://1 \-chapter 5-7
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6465 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6466 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6467 .B Play only titles 5, 6, 7:
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
6468 mplayer dvd://5-7
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6469 .
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
6470 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6471 .B Play a multiangle DVD:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
6472 mplayer dvd://1 \-dvdangle 2
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6473 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6474 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6475 .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
6476 mplayer dvd://1 \-dvd-device /dev/\:dvd2
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6477 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6478 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6479 .B Stream from HTTP:
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
6480 mplayer http://mplayer.hq/\:example.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6481 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6482 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6483 .B Stream using RTSP:
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
6484 mplayer rtsp://server.example.com/\:streamName
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6485 .
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
6486 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6487 .B Convert subtitles to MPsub format:
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
6488 mplayer dummy.avi \-sub source.sub \-dumpmpsub
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6489 .
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
6490 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6491 .B Convert subtitles to MPsub format without watching the movie:
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6492 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
6493 \-benchmark \-sub source.sub \-dumpmpsub
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6494 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
6495 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6496 .B input from standard V4L:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
6497 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
6498 \-vo xv
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6499 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6500 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6501 .B Playback on Zoran cards (old style, deprecated):
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
6502 mplayer \-vo zr \-vf scale=352:288 file.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6503 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
6504 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6505 .B Playback on Zoran cards (new style):
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
6506 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6507 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
6508 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6509 .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
6510 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
6511 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6512 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6513 .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
6514 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
6515 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6516 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6517 .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
6518 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
6519 \-ovc lavc \-lavcopts vcodec=mpeg4
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6520 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6521 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6522 .B The same, but with bitrate set to 1800kBit and optimized macroblocks:
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6523 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6524 \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6525 .
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6526 .TP
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6527 .B The same, but with MJPEG compression
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
6528 mencoder dvd://2 \-o titel2.avi \-ovc lavc
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6529 \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 \-oac copy
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6530 .
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6531 .TP
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6532 .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
6533 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
6534 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6535 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6536 .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
6537 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
6538 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
6539 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6540 .B Encode from a pipe:
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
6541 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
6542 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6543 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6544 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6545 .\" Bugs, authors, standard disclaimer
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6546 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6547 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6548 .SH BUGS
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
6549 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
6550 of the documentation first.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
6551 Many bugs are the result of incorrect setup or parameter usage.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6552 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
6553 explains how to create useful bug reports.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6554 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6555 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6556 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
6557 .SH AUTHORS
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6558 MPlayer was initially written by Arpad Gereffy.
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
6559 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
6560 .PP
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6561 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
6562 .PP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6563 This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6564 It is maintained by Diego Biurrun.
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
6565 Please send mails about it to the MPlayer-DOCS mailing list.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
6566 .\" end of file