annotate DOCS/man/en/mplayer.1 @ 13789:0c11de3fb17a

fs_res desc for vo_quartz
author nplourde
date Thu, 28 Oct 2004 15:33:40 +0000
parents 50b4c7da30b5
children 92a9afe47452
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 .
13698
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
36 .TH MPlayer 1 "2004-10-20" "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
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
196 Usage examples to get you started quickly can be found at the end
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
197 of this man page.
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
198 .PP
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
199 .B Also see the HTML documentation!
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
200 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
201 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
202 .\" --------------------------------------------------------------------------
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
203 .\" Keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
204 .\" --------------------------------------------------------------------------
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
205 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
206 .SH "KEYBOARD CONTROL"
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
207 MPlayer has a fully configurable, command-driven control layer
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
208 which allows you to control MPlayer using keyboard, mouse, joystick
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
209 or remote control (with LIRC).
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
210 See the \-input option for ways to customize it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
211 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
212 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
213 .B general control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
214 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
215 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
216 .IPs "<\- and \->"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
217 Seek backward/\:forward 10 seconds.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
218 .IPs "up and down"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
219 Seek backward/\:forward 1 minute.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
220 .IPs "pgup and pgdown"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
221 Seek backward/\:forward 10 minutes.
13710
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
222 .IPs "[ and ]"
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
223 Decreases/increases current playback speed by 10%.
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
224 .IPs "{ and }"
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
225 Halves/doubles current playback speed.
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
226 .IPs "Backspace"
d7af73cc38da allow changing playback speed during playback.
reimar
parents: 13698
diff changeset
227 Reset playback speed to normal.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
228 .IPs "< and >"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
229 backward/\:forward in playlist
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
230 .IPs "HOME and END"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
231 next/\:previous playtree entry in the parent list
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
232 .IPs "INS and DEL"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
233 next/\:previous alternative source (ASX playlist only)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
234 .IPs "p / SPACE"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
235 Pause movie (any key unpauses).
13726
da328456c758 small fixes
diego
parents: 13725
diff changeset
236 .IPs .\ \ \ \
13626
741649fe31cb allow to step only one frame forward by pressing s.
reimar
parents: 13613
diff changeset
237 Step forward.
741649fe31cb allow to step only one frame forward by pressing s.
reimar
parents: 13613
diff changeset
238 Pressing once will pause movie, every consecutive press will play one frame
741649fe31cb allow to step only one frame forward by pressing s.
reimar
parents: 13613
diff changeset
239 and then go into pause mode again (any other key unpauses).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
240 .IPs "q / ESC"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
241 Stop playing and quit.
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
242 .IPs "+ and -"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
243 Adjust audio delay by +/\:- 0.1 seconds.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
244 .IPs "/ and *"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
245 Decrease/\:increase volume.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
246 .IPs "9 and 0"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
247 Decrease/\:increase volume.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
248 .IPs m\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
249 Mute sound.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
250 .IPs f\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
251 Toggle fullscreen (also see \-fs).
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
252 .IPs T\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
253 Toggle stay-on-top (also see \-ontop).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
254 .IPs "w and e"
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
255 Decrease/\:increase pan-and-scan range.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
256 .IPs o\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
257 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
258 .IPs d\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
259 Toggle frame dropping states: none / skip display / skip decoding
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
260 (see \-framedrop and \-hardframedrop).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
261 .IPs v\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
262 Toggle subtitle visibility.
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
263 .IPs "b / j"
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
264 Cycle through the available subtitles.
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
265 .IP F\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
266 Toggle displaying "forced subtitles".
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
267 .IPs a\ \ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
268 Toggle subtitle aligment: top/\:middle/\:bottom.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
269 .IPs "z and x"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
270 Adjust subtitle delay by +/\:- 0.1 seconds.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
271 .IPs "r and t"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
272 Move subtitles up/\:down.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
273 .IPs i\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
274 Set EDL mark.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
275 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
276 .PD 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
277 .PP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
278 (The following keys are valid only when using a hardware accelerated video
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
279 output (xv, (x)vidix, (x)mga, etc), or the software equalizer filter
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
280 (\-vf eq or \-vf eq2).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
281 .PP
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
282 .PD 0
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
283 .RSs
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
284 .IPs "1 and 2"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
285 Adjust contrast.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
286 .IPs "3 and 4"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
287 Adjust brightness.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
288 .IPs "5 and 6"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
289 Adjust hue.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
290 .IPs "7 and 8"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
291 Adjust saturation.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
292 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
293 .PD 1
13725
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
294 .PP
13726
da328456c758 small fixes
diego
parents: 13725
diff changeset
295 (The following keys are valid only when using the quartz video output driver.)
13725
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
296 .PP
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
297 .PD 0
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
298 .RSs
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
299 .IPs "option + 0"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
300 Resize movie window to half its original size.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
301 .IPs "option + 1"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
302 Resize movie window to its original size.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
303 .IPs "option + 2"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
304 Resize movie window to double its original size.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
305 .IPs "option + f"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
306 Toggle fullscreen (also see \-fs).
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
307 .IPs "option + [ and option + ]"
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
308 Set movie window alpha.
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
309 .IPs T\ \ \ \
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
310 Toggle video layer: ontop/below/normal (also see \-ontop).
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
311 .RE
4318d1bd74cd quartz vo driver specific key binding definition
nplourde
parents: 13723
diff changeset
312 .PD 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
313 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
314 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
315 .B GUI keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
316 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
317 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
318 .IPs ENTER
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
319 Start playing.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
320 .IPs s\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
321 Stop playing.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
322 .IPs l\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
323 Load file.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
324 .IPs c\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
325 Skin browser.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
326 .IPs p\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
327 Toggle playlist.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
328 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
329 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
330 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
331 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
332 .B TV input control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
333 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
334 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
335 .IPs "h and k"
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
336 Select previous/\:next channel.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
337 .IPs n\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
338 Change norm.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
339 .IPs u\ \ \ \
13135
1659857dd634 keyboard control: some fixes and extensions, punctuation
diego
parents: 13134
diff changeset
340 Change channel list.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
341 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
342 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
343 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
344 .
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
345 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
346 .\" Options
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
347 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
348 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
349 .SH "USAGE"
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
350 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
351 \-fs option is \-nofs.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
352 .PP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
353 If an option is marked as (XXX only), it will only work in combination with
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
354 the XXX option or if XXX is compiled in.
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
355 .PP
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
356 You can put all of the options in a configuration file which will be read
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
357 every time MPlayer is run.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
358 The system-wide configuration file 'mplayer.conf' is in your configuration
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
359 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
360 specific one is '~/\:.mplayer/\:config'.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
361 User specific options override system-wide options and options given on the
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
362 command line override either.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
363 The syntax of the configuration files is 'option=<value>', everything after
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
364 a '#' is considered a comment.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
365 Options that work without values can be enabled by setting them to 'yes'
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
366 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
367 Even suboptions can be specified in this way.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
368 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
369 .I EXAMPLE:
13159
edeba26483a1 simplification
diego
parents: 13158
diff changeset
370 .nf
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
371 # Use Matrox driver by default.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
372 vo=xmga
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
373 # I love practicing handstands while watching videos.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
374 flip=yes
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
375 # Decode/\:encode multiple files from png,
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
376 # start with mf://filemask
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
377 mf=type=png:fps=25
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
378 # Eerie negative images are cool.
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
379 vf=eq2=1.0:-0.8
13159
edeba26483a1 simplification
diego
parents: 13158
diff changeset
380 .fi
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
381 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
382 You can also write file-specific configuration files.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
383 If you wish to have a configuration file for a file called 'movie.avi', create a file
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
384 named 'movie.avi.conf' with the file-specific options in it and put it in
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
385 ~/.mplayer or in the same directory as the file.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
386 .
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
387 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
388 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
389 .SH "GENERAL OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
390 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
391 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
392 .B \-codecs-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
393 Use the specified file instead of system wide installed or builtin codecs.conf.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
394 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
395 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
396 .B \-include <configuration\ file>
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
397 Specify configuration file to be parsed after the default ones.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
398 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
399 .TP
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
400 .B \-quiet\ \
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
401 Make console output less verbose; in particular, prevents the status line
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
402 (i.e.\& A: 0.7 V: 0.6 A-V: 0.068 ...) from being displayed.
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
403 Particularly useful on slow terminals or broken ones which do not properly
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
404 handle carriage return (i.e.\& \\r).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
405 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
406 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
407 .B \-v, \-verbose
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
408 Increment verbose level (more \-v means more verbosity).
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
409 .PD 0
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
410 .RSs
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
411 .IPs 0
11949
86da102d74d8 slight wording improvement, noticed by Dominik
diego
parents: 11943
diff changeset
412 only some informational output (default)
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
413 .IPs 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
414 some basic debug infos, avi header, function values (init debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
415 .IPs 2
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
416 print avi indexes, chunk inputs, more debug infos (player debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
417 .IPs 3
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
418 prints everything related to input parsers (parser debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
419 .RE
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
420 .PD 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
421 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
422 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
423 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
424 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
425 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
426 .TP
11448
gabucino
parents: 11446
diff changeset
427 .B \-autoq <quality> (use with \-vf [s]pp)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
428 Dynamically changes the level of postprocessing depending on the available spare
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
429 CPU time.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
430 The number you specify will be the maximum level used.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
431 Usually you can use some big number.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
432 You have to use \-vf [s]pp without parameters in order for this to work.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
433 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
434 .TP
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
435 .B \-autosync <factor>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
436 Gradually adjusts the A/\:V sync based on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
437 Specifying \-autosync\ 0, the default, will cause frame timing to be based
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
438 entirely on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
439 Specifying \-autosync\ 1 will do the same, but will subtly change the A/\:V
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
440 correction algorithm.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
441 An uneven video framerate in a movie which plays fine with \-nosound can
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
442 often be helped by setting this to an integer value greater than 1.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
443 The higher the value, the closer the timing will be to \-nosound.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
444 Try \-autosync\ 30 to smooth out problems with sound drivers which do
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
445 not implement a perfect audio delay measurement.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
446 With this value, if large A/\:V sync offsets occur, they will only take about
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
447 1 or 2\ seconds to settle out.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
448 This delay in reaction time to sudden A/\:V offsets should be the only
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
449 side-effect of turning this option on, for all sound drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
450 .
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
451 .TP
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
452 .B \-benchmark
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
453 Prints some statistics on CPU usage and dropped frames at the end of playback.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
454 Use in combination with \-nosound and \-vo null for benchmarking only the
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
455 video codec.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
456 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
457 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
458 With this option MPlayer will also ignore frame duration when playing
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
459 only video (you can think of that as infinite fps).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
460 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
461 .TP
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
462 .B \-colorkey <number>
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
463 Changes the colorkey to an RGB value of your choice.
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
464 0x000000 is black and 0xffffff is white.
11224
00e639844c85 colorkeying fixes
alex
parents: 11203
diff changeset
465 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
00e639844c85 colorkeying fixes
alex
parents: 11203
diff changeset
466 xover video out drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
467 .
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
468 .TP
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
469 .B \-nocolorkey
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
470 Disables colorkeying.
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
471 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
472 xover video out drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
473 .
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
474 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
475 .B \-edl <filename> (EDL only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
476 Enables edit decision list (EDL) actions during playback.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
477 Video will be skipped over and audio will be muted and unmuted according to
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
478 the entries in the given file.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
479 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
480 .
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
481 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
482 .B \-edlout <filename> (EDL only)
8552
37dd9f68ab71 - and -use-stdin documented, EDL updates.
diego
parents: 8541
diff changeset
483 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
484 During playback, when the user hits 'i', an entry to skip over the last two
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
485 seconds of playback will be written to the file.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
486 This provides a starting point from which the user can fine-tune EDL entries
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
487 later.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
488 See DOCS/\:HTML/\:en/\:edl.html for details.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
489 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
490 .TP
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
491 .B \-enqueue (GUI only)
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
492 Enqueue files given on the command line in the playlist instead of playing them
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
493 immediately.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
494 .
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
495 .TP
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
496 .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
497 Enforces a fixed video system for multiple files (one (un)initialisation for
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
498 all files).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
499 Therefore only one window will be opened for all files.
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
500 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
501 xmga, xv, xvidix and dfbmga.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
502 .
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
503 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
504 .B \-framedrop (also see \-hardframedrop)
9269
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
505 Skip displaying some frames to maintain A/\:V sync on slow systems.
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
506 Video filters are not applied to such frames.
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
507 For B-frames even decoding is skipped completely.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
508 .
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
509 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
510 .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
511 Show short summary of options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
512 .
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
513 .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
514 .B \-hardframedrop
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
515 More intense frame dropping (breaks decoding).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
516 Leads to image distortion!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
517 .
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
518 .TP
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
519 .B \-identify
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
520 Show file parameters in an easily parseable format.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
521 The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
522 (hopefully) shellescapes the filenames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
523 .
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
524 .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
525 .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
526 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
527 Paths are relative to ~/\:.mplayer/.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
528 .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
529 .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
530 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
531 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
532 Available commands are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
533 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
534 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
535 .RSs
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
536 .IPs conf=<filename>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
537 Specify input configuration file other than the default
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
538 ~/\:.mplayer/\:input.conf.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
539 ~/\:.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
540 .IPs ar-delay
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
541 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
542 .IPs ar-rate
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
543 Number of key presses to generate per second on autorepeat.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
544 .IPs keylist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
545 Prints all keys that can be bound to commands.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
546 .IPs cmdlist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
547 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
548 .IPs js-dev
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
549 Specifies the joystick device to use (default: /dev/\:input/\:js0).
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
550 .IPs file\
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
551 Read commands from the given file.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
552 Mostly useful with a FIFO.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
553 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
554 .I NOTE:
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
555 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
556 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
557 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
558 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
559 .
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
560 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
561 .B \-lircconf <filename> (LIRC only)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
562 Specifies a configuration file for LIRC (default: ~/\:.lircrc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
563 .
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 .TP
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
565 .B \-list-options
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
566 Prints out all the available options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
567 .
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
568 .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
569 .B \-loop <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
570 Loops movie playback <number> times.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
571 0 means forever.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
572 .
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
573 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
574 .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
575 Turn on OSD menu support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
576 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
577 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
578 .B \-menu-cfg <filename> (OSD menu only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
579 Use an alternative menu.conf.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
580 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
581 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
582 .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
583 Specify the main menu.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
584 .
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
585 .TP
13368
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
586 .B \-menu-startup (OSD menu only)
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
587 Display the main menu at MPlayer startup.
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
588 .
2c39a359d141 -menu-startup, based on patch by Aurelien Jacobs <aurel at gnuage dot org>
diego
parents: 13364
diff changeset
589 .TP
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
590 .B \-noconsolecontrols
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
591 Prevent MPlayer from reading key events from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
592 Useful when reading data from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
593 This is automatically enabled when \- is found on the command line.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
594 There are situations where you have to set it manually, e.g.\&
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
595 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
596 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
597 loadlist slave commands.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
598 .
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
599 .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
600 .B \-nojoystick
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
601 Turns off joystick support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
602 .
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
603 .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
604 .B \-nolirc
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
605 Turns off LIRC support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
606 .
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
607 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
608 .B \-nomouseinput (X11 only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
609 Disable mouse button press/\:release input (mozplayerxp's context menu relies
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
610 on this option).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
611 .
10761
040c2011aace fixing alphabetic order
gabucino
parents: 10760
diff changeset
612 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
613 .B \-nortc (RTC only)
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
614 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
615 mechanism.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
616 .
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
617 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
618 .B \-playlist <filename>
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
619 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
620 one-file-per-line format).
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
621 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
622 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
623 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
624 only to the elements of this playlist.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
625 .br
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
626 FIXME: This needs to be clarified and documented thoroughly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
627 .
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
628 .TP
12715
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
629 .B \-really-quiet (also see \-quiet)
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
630 Display even less output and status messages than with \-quiet.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
631 .
8234
ebf9a61bb88c -really-quiet documented
diego
parents: 8221
diff changeset
632 .TP
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
633 .B \-rtc-device <device>
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
634 Use the specified device for RTC timing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
635 .
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
636 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
637 .B \-shuffle
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
638 Play files in random order.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
639 .
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
640 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
641 .B \-skin <name> (GUI only)
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
642 Loads a skin from the directory given as parameter below the default skin
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
643 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
644 .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
645 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
646 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
647 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
648 .IPs "\-skin fittyfene"
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
649 Tries /usr/\:local/\:share/\:mplayer/\:Skin/\:fittyfene
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
650 and afterwards ~/.mplayer/\:Skin/\:fittyfene.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
651 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
652 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
653 .
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
654 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
655 .B \-slave (also see \-input)
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
656 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
657 Instead of intercepting keyboard events, MPlayer will read commands from stdin.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
658 .br
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
659 .I NOTE:
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
660 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
661 for their description.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
662 .
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
663 .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
664 .B \-softsleep
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
665 Use high-quality software timers instead of the RTC.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
666 As precise as the RTC without requiring special privileges.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
667 Comes at the price of higher CPU consumption.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
668 .
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
669 .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
670 .B \-speed <0.01\-100>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
671 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
672 .
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
673 .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
674 .B \-sstep <sec>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
675 Display one frame every <sec> seconds.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
676 Useful for slideshows.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
677 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
678 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
679 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
680 .SH "DEMUXER/\:STREAM OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
681 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
682 .TP
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
683 .B \-a52drc <level>
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
684 Select the Dynamic Range Compression level for AC3 audio streams.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
685 <level> is a float value ranging from 0 to 1, where 0 means no compression
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
686 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
687 silent and vice versa).
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
688 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
689 compression information.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
690 .
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
691 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
692 .B \-aid <ID> (also see \-alang)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
693 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
694 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
695 MPlayer prints the available IDs when run in verbose (\-v) mode.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
696 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
697 (if present) with the chosen audio stream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
698 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
699 .TP
13556
1b2b37c0bd4d -alang needs a language code, not a country code.
diego
parents: 13545
diff changeset
700 .B \-alang <language\ code> (also see \-aid)
13543
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
701 Play the audio stream whose language matches the given code.
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
702 Different container formats employ different language codes.
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
703 DVDs use ISO 639-1 two letter language codes, Matroska and NUT use ISO 639-2
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
704 three letter language codes while OGM uses a free-form identifier.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
705 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
706 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
707 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
708 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
709 .RSs
13543
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
710 .IPs "mplayer dvd://1 \-alang hu,en"
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
711 Chooses the Hungarian language track on a DVD and falls back on English if
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
712 Hungarian is not available.
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
713 .IPs "mplayer \-alang jpn example.mkv"
090240d3f117 -alang description corrected.
diego
parents: 13533
diff changeset
714 Plays a Matroska file in Japanese.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
715 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
716 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
717 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
718 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
719 .B \-audio-demuxer <number> (\-audiofile only)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
720 Force audio demuxer type for \-audiofile.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
721 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
722 \-audio-demuxer 17 forces MP3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
723 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
724 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
725 .B \-audiofile <filename>
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
726 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
727 movie.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
728 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
729 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
730 .B \-audiofile-cache <kBytes>
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
731 Enables caching for the stream used by \-audiofile, using the specified
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
732 amount of memory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
733 .
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
734 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
735 .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
736 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
737 able to send content in different bitrates).
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
738 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
739 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
740 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
741 .B \-cdrom-device <path\ to\ device>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
742 Specify the CD-ROM device (default: /dev/\:cdrom).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
743 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
744 .TP
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
745 .B \-cache <kBytes>
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
746 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
747 file or URL.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
748 Especially useful on slow media.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
749 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
750 .TP
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
751 .B \-cache-min <percentage>
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
752 Playback will start when the cache fill threshold set with this option
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
753 is reached.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
754 .
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
755 .TP
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
756 .B \-cache-prefill <percentage> (not yet implemented)
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
757 When the cache is emptied MPlayer will pause and restart playback when
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
758 the cache prefill threshold set with this option is reached.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
759 .
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
760 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
761 .B \-cdda <option1:option2> (CDDA only)
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
762 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
763 .sp 1
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
764 Available options are:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
765 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
766 .IPs speed=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
767 Set CD spin speed.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
768 .IPs paranoia=<0\-2>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
769 Set paranoia level.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
770 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
771 0: disable checking
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
772 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
773 1: overlap checking only (default)
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
774 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
775 2: full data correction and verification
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
776 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
777 .IPs generic-dev=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
778 Use specified generic SCSI device.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
779 .IPs sector-size=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
780 Set atomic read size.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
781 .IPs overlap=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
782 Force minimum overlap search during verification to <value> sectors.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
783 .IPs toc-bias
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
784 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
785 addressed as LBA\ 0.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
786 Some Toshiba drives need this for getting track boundaries correct.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
787 .IPs toc-offset=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
788 Add <value> sectors to the values reported when addressing tracks.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
789 May be negative.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
790 .IPs (no)skip
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
791 (Never) accept imperfect data reconstruction.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
792 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
793 .
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
794 .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
795 .B \-channels <number>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
796 Change the number of playback channels (default: 2).
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
797 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
798 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
799 channel is repeated in both output channels).
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
800 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
801 results depend on the audio decoder (\-afm).
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
802 MPlayer asks the decoder to decode the audio into as many channels as
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
803 specified.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
804 Now it's up to the decoder to fulfill the requirement.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
805 If the decoder outputs more channels than requested, the exceeding channels
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
806 are truncated.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
807 This is usually only important when playing videos with AC3 audio (like DVDs).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
808 In that case liba52 does the decoding by default and correctly downmixes the
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
809 audio into the requested number of channels.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
810 .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
811 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
812 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
813 (OSS at least).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
814 .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
815 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
816 .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
817 .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
818 .RSs
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
819 .IPs 2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
820 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
821 .IPs 4
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
822 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
823 .IPs 6
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
824 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
825 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
826 .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
827 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
828 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
829 .B \-chapter <chapter\ ID>[\-<end\ chapter\ ID>] (DVD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
830 Specify which chapter to start playing at.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
831 Optionally specify which chapter to end playing at (default: 1).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
832 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
833 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
834 .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
835 Send cookies when making HTTP requests.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
836 .
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
837 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
838 .B \-cookies-file <filename> (network only)
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
839 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
840 and skip reading from default locations.
11603
fbef9326c2ed small fixes
diego
parents: 11600
diff changeset
841 The file is assumed to be in Netscape format.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
842 .
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
843 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
844 .B \-demuxer <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
845 Force demuxer type.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
846 Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
847 \-demuxer 17 forces MP3.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
848 .
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
849 .TP
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
850 .B \-dumpaudio (MPlayer only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
851 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
852 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
853 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
854 .B \-dumpfile <filename> (MPlayer only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
855 Specify which file MPlayer should dump to.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
856 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
857 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
858 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
859 .B \-dumpstream (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
860 Dumps the raw stream to ./stream.dump.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
861 Useful when ripping from DVD or network.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
862 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
863 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
864 .B \-dumpvideo (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
865 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
866 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
867 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
868 .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
869 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
870 the default ones:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
871 .sp 1
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
872 .PD 0
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
873 .RSs
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
874 .IPs card=<1\-4>
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
875 Specifies using card number 1\-4 (default: 1).
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
876 .IPs file=<filename>
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
877 Instructs MPlayer to read the channels list from <filename>.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
878 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl} (based on your card type)
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
879 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
880 .RE
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
881 .PD 1
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
882 .
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
883 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
884 .B \-dvd-device <path\ to\ device> (DVD only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
885 Specify the DVD device (default: /dev/\:dvd).
13510
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
886 You can also specify a directory that contains files previously copied directly
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
887 from a DVD (such as with vobcopy).
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
888 Note that using \-dumpstream is usually a better way to
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
889 copy DVD titles in the first place (see the examples).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
890 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
891 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
892 .B \-dvdangle <angle\ ID> (DVD only)
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
893 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
894 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
895 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
896 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
897 .B \-forceidx
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
898 Force index rebuilding.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
899 Useful for files with broken index (A/\:V desync, etc).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
900 This will enable seeking in files where seeking was not possible.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
901 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
902 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
903 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
904 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
905 (i.e.\& not with stdin, pipe, etc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
906 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
907 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
908 .B \-fps <float value>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
909 Override video framerate.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
910 Useful if the original value is wrong or missing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
911 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
912 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
913 .B \-frames <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
914 Play/\:convert only first <number> frames, then quit.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
915 .
472
a25ba0fd865e commiting yesterday's changes that accidently lost ;(((
gabucino
parents: 454
diff changeset
916 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
917 .B \-hr-mp3-seek (MP3 only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
918 Hi-res MP3 seeking.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
919 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
920 to the very exact position to keep A/\:V sync.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
921 Can be slow especially when seeking backwards since it has to rewind
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
922 to the beginning to find an exact frame position.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
923 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
924 .TP
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
925 .B \-idx (also see \-forceidx)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
926 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
927 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
928 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
929 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
930 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
931 (i.e.\& not with stdin, pipe, etc).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
932 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
933 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
934 .B \-ipv4-only-proxy (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
935 Skip the proxy for IPv6 addresses.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
936 It will still be used for IPv4 connections.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
937 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
938 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
939 .B \-loadidx <index file>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
940 The file from which to read the video index data saved by \-saveidx.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
941 This index will be used for seeking, overriding any index data
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
942 contained in the AVI itself.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
943 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
944 from a different AVI, but this is sure to cause unfavorable results.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
945 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
946 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
947 This option is obsolete now that MPlayer has OpenDML support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
948 .
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
949 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
950 .B \-mc <seconds/\:frame>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
951 maximum A-V sync correction per frame (in seconds)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
952 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
953 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
954 .B \-mf <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
955 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
956 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
957 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
958 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
959 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
960 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
961 .IPs w=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
962 output width (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
963 .IPs h=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
964 output height (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
965 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
966 output fps (default: 25)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
967 .IPs type=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
968 input file type (available: jpeg, png, tga, sgi)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
969 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
970 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
971 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
972 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
973 .B \-ni (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
974 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
975 of some bad AVI files).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
976 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
977 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
978 .B \-nobps (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
979 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
980 Helps with some AVI files with broken header.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
981 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
982 .TP
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
983 .B \-noextbased
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
984 Disables extension-based demuxer selection.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
985 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
986 (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
987 extension is used to select the demuxer.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
988 Always falls back on content-based demuxer selection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
989 .
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
990 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
991 .B \-passwd <password> (also see \-user) (network only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
992 Specify password for HTTP authentication.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
993 .
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
994 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
995 .B \-prefer-ipv4 (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
996 Use IPv4 on network connections.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
997 Falls back on IPv6 automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
998 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
999 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1000 .B \-prefer-ipv6 (IPv6 network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
1001 Use IPv6 on network connections.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1002 Falls back on IPv4 automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1003 .
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
1004 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1005 .B \-rawaudio <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1006 This option lets you play raw audio files.
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
1007 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
1008 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
1009 .sp 1
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
1010 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1011 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1012 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1013 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1014 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1015 Use raw audio demuxer.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1016 .IPs channels=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1017 number of channels
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1018 .IPs rate=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1019 rate in samples per second
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1020 .IPs samplesize=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1021 sample size in bytes
12282
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
1022 .IPs bitrate=<value>
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
1023 bitrate for rawaudio files
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1024 .IPs format=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1025 fourcc in hex
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1026 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1027 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1028 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1029 .TP
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1030 .B \-rawvideo <option1:option2:...>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1031 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
1032 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1033 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1034 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1035 .PD 0
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1036 .RSs
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1037 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1038 Use raw video demuxer.
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1039 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1040 rate in frames per second (default: 25.0)
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1041 .IPs sqcif|qcif|cif|4cif|pal|ntsc
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1042 set standard image size
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1043 .IPs w=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1044 image width in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1045 .IPs h=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1046 image height in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1047 .IPs y420|yv12|yuy2|y8
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1048 set colorspace
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1049 .IPs format=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1050 colorspace (fourcc) in hex
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1051 .IPs size=<value>
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
1052 frame size in Bytes
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1053 .RE
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1054 .PD 1
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1055 .
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
1056 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1057 .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
1058 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1059 packets be streamed over TCP (using the same TCP connection as RTSP).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1060 This option may be useful if you have a broken internet connection that does
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1061 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
1062 .
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
1063 .TP
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
1064 .B \-saveidx <filename>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1065 Force index rebuilding and dump the index to <filename>.
11293
e9f585aec12e -loadidx and -saveidx explanation extended.
diego
parents: 11286
diff changeset
1066 Currently this only works with AVI files.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1067 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1068 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1069 This option is obsolete now that MPlayer has OpenDML support.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1070 .
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
1071 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1072 .B \-sb <byte\ position> (also see \-ss)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1073 Seek to byte position.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1074 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
1075 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1076 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1077 .B \-srate <Hz>
11906
47e9cd92d163 Fix description of -srate, as pointed out by Rich.
diego
parents: 11904
diff changeset
1078 Selects the given output sampling rate, resampling if necessary.
13723
d7f78525d89b missing \
wight
parents: 13710
diff changeset
1079 The type of resampling can be controlled by the \-af-adv option.
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
1080 The default is fast resampling that may cause distortion.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1081 MEncoder passes this value to LAME for resampling.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1082 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1083 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1084 .B \-ss <time> (also see \-sb)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1085 Seek to given time position.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1086 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1087 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1088 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1089 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1090 .IPs "\-ss 56"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1091 Seeks to 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1092 .IPs "\-ss 01:10:00"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1093 Seeks to 1\ hour 10\ min.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1094 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1095 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1096 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1097 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1098 .B \-tskeepbroken
11203
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1099 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
1100 Sometimes needed to play corrupted MPEG-TS files.
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1101 .
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
1102 .TP
12994
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1103 .B \-tsprobe <byte\ position>
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1104 When playing an MPEG-TS stream, this option lets you specify how many
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1105 bytes in the stream you want MPlayer to search for the desired
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1106 audio and video pids.
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1107 .
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
1108 .TP
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1109 .B \-tsprog <1\-65534>
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1110 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
1111 program (if present) you want to play.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1112 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
1113 .
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
1114 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1115 .B \-tv <option1:option2:...> (TV only)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1116 This option tunes various properties of the TV capture module.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1117 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
1118 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
1119 as a movie URL.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1120 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1121 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1122 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1123 .IPs noaudio
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1124 no sound
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1125 .IPs driver=<value>
10537
31f12f99118b v4l2 support
henry
parents: 10524
diff changeset
1126 available: dummy, v4l, v4l2, bsdbt848
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1127 .IPs device=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1128 Specify TV device (default: /dev/\:video0).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1129 .IPs input=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1130 Specify input (default: 0 (TV), see console output for available inputs).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1131 .IPs freq=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1132 Specify the frequency to set the tuner to (e.g.\& 511.250).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1133 Not compatible with the channels parameter.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1134 .IPs outfmt=<value>
11365
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1135 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
1136 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
1137 arbitrary format given as hex value.
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1138 Try outfmt=help for a list of all available formats.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1139 .IPs width=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1140 output window width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1141 .IPs height=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1142 output window height
8879
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1143 .IPs fps=<value>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1144 framerate at which to capture video (frames per second)
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1145 .IPs buffersize=<value>
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
1146 maximum size of the capture buffer in megabytes (default: dynamical)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1147 .IPs norm=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1148 available: PAL, SECAM, NTSC.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1149 For v4l2 use the normid option below.
13016
61d0fd8411cc Missing quotes added
wight
parents: 13014
diff changeset
1150 .IPs "normid=<value> (v4l2 only)"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1151 See console output for a list of available TV norms.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1152 .IPs channel=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1153 Set tuner to <value> channel.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1154 .IPs chanlist=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1155 available: europe-east, europe-west, us-bcast, us-cable, etc
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
1156 .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
1157 Set names for channels.
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1158 Use _ for spaces in names (or play with quoting ;-).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1159 The channel names will then be written using OSD, and the slave commands
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1160 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
1161 a remote control (see LIRC).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1162 Not compatible with the frequency parameter.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1163 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1164 .I NOTE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1165 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
1166 beginning with 1.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1167 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1168 .I EXAMPLE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1169 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
1170 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1171 Set the image equalizer on the card.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1172 .IPs audiorate=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1173 Set audio capture bitrate.
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1174 .IPs forceaudio
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1175 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
1176 .IPs alsa\
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1177 Capture from ALSA.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1178 .IPs amode=<0\-3>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1179 Choose an audio mode:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1180 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1181 0: mono
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1182 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1183 1: stereo
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1184 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1185 2: language 1
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1186 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1187 3: language 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1188 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1189 .IPs forcechan=<1\-2>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1190 By default, the count of recorded audio channels is determined automatically
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1191 by querying the audio mode from the TV card.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1192 This option allows forcing stereo/\:mono recording regardless of the amode
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1193 option and the values returned by v4l.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1194 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
1195 current audio mode.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1196 .IPs adevice=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1197 Set an audio device.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1198 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1199 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
1200 .IPs audioid=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1201 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
1202 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1203 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1204 These options set parameters of the mixer on the video capture card.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1205 They will have no effect, if your card does not have one.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1206 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
1207 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
1208 .IPs immediatemode=<bool>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1209 A value of 0 means capture and buffer audio and video together
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1210 (default for MEncoder).
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1211 A value of 1 (default for MPlayer) means to do video capture only and let the
13533
diego
parents: 13525
diff changeset
1212 audio go through a loopback cable from the TV card to the sound card.
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1213 .IPs mjpeg
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1214 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
1215 When using this option, you do not need to specify the width and height
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1216 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
1217 from the decimation value (see below).
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1218 .IPs decimation=<1,2,4>
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1219 choose the size of the picture that will be compressed by hardware
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1220 MJPEG compression:
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1221 .RSss
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1222 1: full size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1223 704x576 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1224 704x480 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1225 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1226 2: medium size
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1227 352x288 PAL
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1228 352x240 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1229 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1230 4: small size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1231 176x144 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1232 176x120 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Ivn Sznt <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1233 .REss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1234 .IPs quality=<0\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1235 Choose the quality of the JPEG compression
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1236 (< 60 recommended for full size).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1237 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1238 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1239 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1240 .B \-user <username> (also see \-passwd) (network only)
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1241 Specify username for HTTP authentication.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1242 .
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
1243 .TP
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1244 .B \-user-agent <string>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1245 Use <string> as user agent for HTTP streaming.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1246 .
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1247 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
1248 .B \-vid <ID>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1249 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1250 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
1251 (if present) with the chosen video stream.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1252 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1253 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1254 .B \-vivo <sub-options> (DEBUG CODE)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1255 Force audio parameters for the VIVO demuxer (for debugging purposes).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1256 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1257 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1258 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1259 .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
1260 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1261 Also see \-vf expand.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1262 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1263 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1264 .B \-dumpjacosub (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1265 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1266 JACOsub subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1267 Creates a dumpsub.js file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1268 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1269 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1270 .B \-dumpmicrodvdsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1271 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
1272 MicroDVD subtitle format.
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1273 Creates a dumpsub.sub file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1274 .
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1275 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1276 .B \-dumpmpsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1277 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
1278 subtitle format, MPsub.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1279 Creates a dump.mpsub file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1280 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1281 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1282 .B \-dumpsami (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1283 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1284 SAMI subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1285 Creates a dumpsub.smi file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1286 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1287 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1288 .B \-dumpsrtsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1289 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
1290 SubViewer (SRT) subtitle format.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1291 Creates a dumpsub.srt file in the current directory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1292 .
6378
64a828f1872b added -dumpsrtsub
gabucino
parents: 6351
diff changeset
1293 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1294 .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
1295 Dumps the subtitle substream from VOB streams.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1296 Also see the \-dump*sub and \-vobsubout* options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1297 .
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
1298 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1299 .B \-ffactor <number> (OSD only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1300 Resample the font alphamap.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1301 Can be:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1302 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1303 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1304 .IPs 0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1305 plain white fonts
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1306 .IPs 0.75
8762
75d22ee5f975 Per-file configuration, typos, rewordings, consistency and a 10l .In.
diego
parents: 8745
diff changeset
1307 very narrow black outline (default)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1308 .IPs 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1309 narrow black outline
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1310 .IPs 10
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1311 bold black outline
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1312 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1313 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1314 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1315 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1316 .B \-flip-hebrew (FriBiDi only)
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1317 Turns on flipping subtitles using FriBiDi.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1318 .
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1319 .TP
13679
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1320 .B \-noflip-hebrew-commas
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1321 Change FriBiDi's assumptions about the placements of commas in subtitles.
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1322 Use this if commas in subtitles are shown at the start of a sentence
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1323 instead of at the end.
59bb11213d11 correctly display the commas of most hebrew subtitles on the left side
faust3
parents: 13661
diff changeset
1324 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1325 .B \-font <path\ to\ font.desc\ file> (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1326 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
1327 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1328 ~/.mplayer/\:subfont.ttf).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1329 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1330 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1331 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
1332 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
1333 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1334 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1335 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1336 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1337 \-font ~/\:.mplayer/\:arial-14/\:font.desc
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1338 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1339 \-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
1340 .br
90953d955165 Fontconfig support based on patch by Arwed von Merkatz <v.merkatz@gmx.net>, but slightly reworked
alex
parents: 11572
diff changeset
1341 \-font 'Bitstream Vera Sans'
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1342 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1343 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1344 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1345 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1346 .B \-fontconfig (fontconfig only)
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1347 Enables the usage of fontconfig managed fonts.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1348 .
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1349 .TP
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1350 .B \-forcedsubsonly
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1351 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
1352 \-slang.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1353 .
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1354 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1355 .B \-fribidi-charset <charset\ name> (FriBiDi only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1356 Specifies the character set that will be passed to FriBiDi when
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1357 decoding non-UTF-8 subtitles (default: ISO8859-8).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1358 .
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1359 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1360 .B \-ifo <VOBsub\ ifo\ file>
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1361 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
1362 subtitles.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1363 .
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1364 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1365 .B \-noautosub
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1366 Turns off automatic subtitle file loading.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1367 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1368 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1369 .B \-osdlevel <0\-3> (MPlayer only)
8810
bdcde34deb14 10l, osdlevel, fixes
jonas
parents: 8806
diff changeset
1370 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
1371 .PD 0
8811
jonas
parents: 8810
diff changeset
1372 .RSs
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1373 .IPs 0
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1374 subtitles only
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1375 .IPs 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1376 volume + seek (default)
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1377 .IPs 2
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1378 volume + seek + timer + percentage
9162
jonas
parents: 9139
diff changeset
1379 .IPs 3
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1380 volume + seek + timer + percentage + total time
8811
jonas
parents: 8810
diff changeset
1381 .RE
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1382 .PD 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1383 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1384 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1385 .B \-overlapsub
10393
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1386 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
1387 still visible (default is to enable the support only for specific
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1388 formats).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1389 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1390 .TP
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1391 .B \-sid <ID> (also see \-slang option)
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1392 Display DVD subtitles in the language specified by <ID> (0\-31).
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1393 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
1394 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1395 .TP
13160
7dbbfba0a722 better -slang description inspired by a patch from Guillaume Poirier
diego
parents: 13159
diff changeset
1396 .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
1397 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
1398 Languages must be given as two letter country codes.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1399 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
1400 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1401 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1402 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1403 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1404 .IPs "\-slang hu,en"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1405 Selects Hungarian and falls back on English if Hungarian is not available.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1406 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1407 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1408 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1409 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1410 .B \-spuaa <mode> (OSD only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1411 Antialiasing/\:scaling mode for DVD/\:VOBsub.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1412 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
1413 when original and scaled frame size already match.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1414 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1415 Available modes are:
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1416 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1417 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1418 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1419 none (fastest, very ugly)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1420 .IPs 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1421 approximate (broken?)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1422 .IPs 2
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1423 full (slow)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1424 .IPs 3
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1425 bilinear (default, fast and not too bad)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1426 .IPs 4
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1427 uses swscaler gaussian blur (looks very good)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1428 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1429 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1430 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1431 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1432 .B \-spualign <-1\-2> (OSD only)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1433 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1434 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1435 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1436 .IPs -1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1437 original position
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1438 .IPs 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1439 align at top (original/\:default behavior)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1440 .IPs 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1441 align at center
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1442 .IPs 2
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1443 align at bottom
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1444 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1445 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1446 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1447 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1448 .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
1449 Variance parameter of gaussian used by \-spuaa 4.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1450 Higher means more blur (default: 1.0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1451 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1452 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1453 .B \-sub <subtitlefile1,subtitlefile2,...>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1454 Use/\:display these subtitle files.
13134
2c3a4098f40c Cycle through the available subtitles with 'b'.
diego
parents: 13107
diff changeset
1455 Only one file can be displayed at the same time.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1456 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1457 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1458 .B \-sub-bg-alpha <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1459 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
1460 Big values mean more transparency.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1461 0 means completely transparent.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1462 .
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1463 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1464 .B \-sub-bg-color <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1465 Specify the color value for subtitles and OSD backgrounds.
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1466 Currently subtitles are grayscale so this value is equivalente to the
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1467 intensity of the color.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1468 255 means white and 0 black.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1469 .
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1470 .TP
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1471 .B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1472 Force subtitle demuxer type for \-subfile.
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1473 Give the demuxer ID as defined in subreader.h.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1474 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1475 .TP
11448
gabucino
parents: 11446
diff changeset
1476 .B \-sub-fuzziness <mode>
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1477 Adjust matching fuzziness when searching for subtitles:
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1478 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1479 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1480 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1481 exact match
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1482 .IPs 1
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1483 Load all subs containing movie name.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1484 .IPs 2
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1485 Load all subs in the current directory.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1486 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1487 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1488 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1489 .TP
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1490 .B \-sub-no-text-pp
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1491 Disables any kind of text post processing done after loading the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1492 Used for debug purposes.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1493 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1494 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1495 .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
1496 Specify how subtitles should be aligned with \-subpos.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1497 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1498 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1499 .IPs 0
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
1500 Align at top (original/\:default behavior).
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1501 .IPs 1
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
1502 Align at center.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1503 .IPs 2
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
1504 Align at bottom.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1505 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1506 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1507 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1508 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1509 .B \-subcc \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1510 Display DVD Closed Caption (CC) subtitles.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1511 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
1512 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
1513 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
1514 .
7049
0caeda287ff9 -subcc option documented, patch by Robert R. Wal <rrw at hell pl>.
diego
parents: 7045
diff changeset
1515 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1516 .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
1517 If your system supports iconv(3), you can use this option to
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1518 specify the subtitle codepage.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1519 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1520 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1521 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1522 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1523 \-subcp latin2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1524 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1525 \-subcp cp1250
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1526 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1527 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1528 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1529 .TP
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1530 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1531 You can specify your language using a two letter language code to
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1532 make ENCA detect the codepage automatically.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1533 If unsure, enter anything and watch mplayer \-v output for available
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1534 languages.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1535 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
1536 .sp 1
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1537 .I EXAMPLE:
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1538 .PD 0
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1539 .RSs
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1540 .IPs "\-subcp enca:cs:latin2"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1541 Guess the encoding, assuming the subtitles are Czech, fall back on
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1542 latin 2, if the detection fails.
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1543 .IPs "\-subcp enca:pl:cp1250"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1544 Guess the encoding for Polish, fall back on cp1250.
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1545 .RE
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1546 .PD 1
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1547 .
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1548 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1549 .B \-subdelay <sec>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1550 Delays subtitles by <sec> seconds.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1551 Can be negative.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1552 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1553 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1554 .B \-subfile <filename> (BETA CODE)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1555 Currently useless.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1556 Same as \-audiofile, but for subtitle streams (OggDS?).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1557 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1558 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1559 .B \-subfont-autoscale <0\-3> (FreeType only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1560 Sets the autoscale mode.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1561 .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
1562 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1563 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
1564 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1565 The mode can be:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1566 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1567 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1568 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1569 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1570 no autoscale
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1571 .IPs 1
8265
rfelker
parents: 8248
diff changeset
1572 proportional to movie height
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1573 .IPs 2
8265
rfelker
parents: 8248
diff changeset
1574 proportional to movie width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1575 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1576 proportional to movie diagonal (default)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1577 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1578 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1579 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1580 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1581 .B \-subfont-blur <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1582 Sets the font blur radius (default: 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1583 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1584 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1585 .B \-subfont-encoding <value> (FreeType only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1586 Sets the font encoding.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1587 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
1588 unicode will be used (default: unicode).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1589 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1590 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1591 .B \-subfont-osd-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1592 Sets the autoscale coefficient of the OSD elements (default: 6).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1593 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1594 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1595 .B \-subfont-outline <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1596 Sets the font outline thickness (default: 2).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1597 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1598 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1599 .B \-subfont-text-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1600 Sets the subtitle text autoscale coefficient as percentage of the
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1601 screen size (default: 5).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1602 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1603 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1604 .B \-subfps <rate>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1605 Specify the framerate of the subtitle file (default: movie fps).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1606 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1607 .I NOTE:
13364
034bdc681643 MicroDVD IS a frame-based subtitle format, mistake noticed by Jiri Heryan
diego
parents: 13363
diff changeset
1608 Only for frame-based subtitle files, i.e.\& MicroDVD format.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1609 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1610 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1611 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1612 Specify the position of subtitles on the screen.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1613 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
1614 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1615 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1616 .B \-subwidth <10\-100> (OSD only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1617 Specify the maximum width of subtitles on the screen.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1618 Useful for TV-out.
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1619 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
1620 .
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1621 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1622 .B \-unicode
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1623 Tells MPlayer to handle the subtitle file as unicode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1624 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1625 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1626 .B \-utf8 \ \
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1627 Tells MPlayer to handle the subtitle file as UTF-8.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1628 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1629 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1630 .B \-vobsub <VOBsub\ file\ without\ extension>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1631 Specify a VOBsub file to use for subtitles.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1632 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
1633 the '.idx', '.ifo' or '.sub'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1634 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1635 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1636 .B \-vobsubid <0\-31>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1637 Specify the VOBsub subtitle ID.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1638 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1639 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1640 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1641 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1642 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1643 .TP
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
1644 .B \-abs <value> (\-ao oss only) (OBSOLETE)
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1645 Override audio driver/\:card buffer size detection.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1646 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1647 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1648 .B \-aofile <filename>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1649 Override the default filename employed by \-ao pcm.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1650 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1651 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
1652 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1653 Specify audio plugin(s) and their options
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
1654 (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
1655 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1656 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1657 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1658 .IPs list=[plugins]
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1659 comma separated list of plugins (resample, surround, format, volume,
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1660 extrastereo, volnorm, delay)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1661 .IPs delay=<sec>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1662 example plugin, do not use (delay plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1663 .IPs format=<format>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1664 output format (format plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1665 .IPs fout=<Hz>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1666 output frequency (resample plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1667 .IPs volume=<0\-255>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1668 volume (volume plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1669 .IPs mul=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1670 stereo coefficient (default: 2.5) (extrastereo plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1671 .IPs softclip
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1672 compressor / 'soft-clipping' capabilities (volume plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1673 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1674 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1675 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1676 .B \-delay <sec>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1677 Audio delay in seconds (positive or negative float value).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1678 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1679 .TP
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1680 .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
1681 Select the format used for output from the filter layer (according to the
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1682 defines in libao2/\:afmt.h):
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1683 .PD 0
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1684 .RSs
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1685 .IPs 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1686 Mu-Law
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1687 .IPs 2
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1688 A-Law
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1689 .IPs 4
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1690 Ima-ADPCM
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1691 .IPs 8
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1692 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
1693 .IPs 16
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1694 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
1695 .IPs 32
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1696 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
1697 .IPs 64
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1698 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
1699 .IPs 128
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1700 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
1701 .IPs 256
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1702 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
1703 .IPs 512
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1704 MPEG (2) Audio
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1705 .IPs 1024
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1706 AC3
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1707 .IPs 4096
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1708 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
1709 .IPs 8192
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1710 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
1711 .RE
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1712 .PD 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1713 .
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1714 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1715 .B \-mixer <device>
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1716 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
1717 For ALSA this is the mixer name.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1718 .
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1719 .TP
13434
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1720 .B \-mixer-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1721 This option will tell MPlayer to use a different channel for controlling
11840
acef84b653a9 small fixes
diego
parents: 11837
diff changeset
1722 volume than the default PCM.
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1723 Options for OSS include
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1724 .B vol, pcm, line.
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1725 For a complete list of options look for SOUND_DEVICE_NAMES in
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1726 /usr/\:include/\:linux/\:soundcard.h.
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1727 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
1728 .B Master, Line, PCM.
13434
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1729 .br
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1730 .I NOTE:
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1731 ALSA mixer channel names followed by a number must be specified in the
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
1732 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
13434
2df414ae2d2a allow to select an alsa mixer channel index.
reimar
parents: 13432
diff changeset
1733 be converted to
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
1734 .BR PCM,1 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1735 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1736 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1737 .B \-nowaveheader (\-ao pcm only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1738 Don't include wave header.
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
1739 Used for raw PCM.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1740 .
13098
907fe1fdfc6c Make the stepsize of volume changes, changeable by a commandline paarameter
attila
parents: 13096
diff changeset
1741 .TP
907fe1fdfc6c Make the stepsize of volume changes, changeable by a commandline paarameter
attila
parents: 13096
diff changeset
1742 .B \-volstep <0\-100>
13104
b818ad985ce9 default style
wight
parents: 13098
diff changeset
1743 Set the step size of mixer volume changes in percent of the whole range
b818ad985ce9 default style
wight
parents: 13098
diff changeset
1744 (default: 3).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1745 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1746 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1747 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1748 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
1749 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
1750 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1751 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1752 .TP
12505
a0b82f1dda7d xvmc and *vidix suboptions documented, better ao/vo suboption syntax
diego
parents: 12479
diff changeset
1753 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1754 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
1755 .PP
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
1756 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
1757 contained in the list.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1758 Suboptions are optional and can mostly be omitted.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1759 .br
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1760 .I NOTE:
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
1761 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
1762 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1763 .I EXAMPLE:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1764 .PD 0
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1765 .RSs
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1766 .IPs "\-ao alsa,oss,"
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1767 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
1768 .IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1769 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
1770 .RE
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1771 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1772 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1773 Available audio output drivers are:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1774 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1775 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1776 .B alsa\ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1777 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
1778 .PD 0
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1779 .RSs
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1780 .IPs mmap\ \ \
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1781 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
1782 .IPs noblock
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1783 Sets noblock-mode.
12807
6494aa5947ee ao_alsa now uses the device= suboption syntax instead of hw= or hw:
reimar
parents: 12778
diff changeset
1784 .IPs device=<device>
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1785 Sets the device name.
12919
aba44b58dea7 Use = instead if # in ALSA device name, as # irritates our config-parser.
reimar
parents: 12867
diff changeset
1786 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
13661
07dc40f25068 Only use S/PDIF output when no other alsa device is set, allows to use
reimar
parents: 13660
diff changeset
1787 Make sure you do not set this when you want hwac3 output via S/PDIF, unless
07dc40f25068 Only use S/PDIF output when no other alsa device is set, allows to use
reimar
parents: 13660
diff changeset
1788 you really know how to set it correctly.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1789 .RE
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1790 .PD 1
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
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1793 .B alsa1x (OBSOLETE)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1794 ALSA 1.x audio output driver.
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1795 Obsoleted by the general alsa audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1796 .
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1797 .TP
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1798 .B alsa9 (OBSOLETE)
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1799 ALSA 0.9 audio output driver.
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1800 Obsoleted by the general alsa audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1801 .
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1802 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1803 .B alsa5\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1804 ALSA 0.5 audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1805 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1806 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1807 .B oss\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1808 OSS audio output driver
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1809 .PD 0
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1810 .RSs
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1811 .IPs dsp-device
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1812 Sets the audio-output device (default: /dev/\:dsp).
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1813 .RE
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1814 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1815 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1816 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1817 .B sdl\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1818 Highly platform independent SDL (Simple Directmedia Layer) library
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1819 audio output driver.
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1820 .PD 0
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1821 .RSs
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1822 .IPs <driver>
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1823 Explicitly choose the SDL audio driver to use (default: let SDL choose).
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1824 .RE
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1825 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1826 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1827 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1828 .B arts\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1829 Audio output through the Arts daemon.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1830 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1831 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1832 .B esd\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1833 Audio output through the ESD daemon.
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1834 .PD 0
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1835 .RSs
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1836 .IPs <server>
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
1837 Explicitly choose the ESD server to use (default: localhost).
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1838 .RE
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1839 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1840 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1841 .TP
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1842 .B jack\ \ \ \
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1843 Audio output through JACK (Jack Audio Connection Kit).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1844 .
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1845 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1846 .B nas\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1847 Audio output through NAS.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1848 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1849 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1850 .B macosx (Mac OS X only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1851 Native Mac OS X audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1852 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1853 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1854 .B sgi (SGI only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1855 Native SGI audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1856 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1857 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1858 .B sun (Sun only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1859 Native Sun audio output driver.
13340
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1860 .PD 0
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1861 .RSs
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1862 .IPs <device>
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1863 Explicitly choose the audio device to use (default: /dev/\:audio).
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1864 .RE
0ed7c089f830 Audio output driver suboptions documented
danny
parents: 13330
diff changeset
1865 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1866 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1867 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1868 .B win32 (Windows only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1869 Native Windows waveout audio output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1870 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1871 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1872 .B dxr2 (also see \-dxr2) (DXR2 only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1873 Creative DXR2 specific output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1874 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1875 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1876 .B mpegpes (DVB only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1877 DVB specific output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1878 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1879 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1880 .B null\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1881 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
1882 Use \-nosound for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1883 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1884 .TP
13076
2e15bacb1897 missing \
wight
parents: 13068
diff changeset
1885 .B pcm (also see \-aofile)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
1886 Raw PCM/\:wave file writer audio output.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1887 Writes the sound to ./audiodump.wav.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1888 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1889 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1890 .B plugin\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1891 Plugin audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1892 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1893 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1894 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1895 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1896 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1897 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1898 .B \-aa* (\-vo aa only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1899 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
1900 .I mplayer \-aahelp
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1901 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1902 .TP
12389
0b1053e9d8da -adapter is not directx specific anymore.
diego
parents: 12388
diff changeset
1903 .B \-adapter <value>
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1904 Set the graphics card that will receive the image.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1905 Needs the \-vm option to work.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1906 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
1907 Works currently only with \-vo directx.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1908 .
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1909 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1910 .B \-bpp <depth>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1911 Override the autodetected color depth.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1912 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
1913 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1914 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1915 .B \-brightness <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1916 Adjust the brightness of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1917 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1918 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1919 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1920 .B \-contrast <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1921 Adjust the contrast of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1922 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1923 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1924 .TP
12013
d0a1e865c1af -vo directfb options by Jiri Svoboda
diego
parents: 11993
diff changeset
1925 .B \-dfbopts <value> (\-vo directfb only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1926 Specify a parameter list for the directfb video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1927 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1928 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1929 .B \-display <name> (X11 only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1930 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
1931 on.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1932 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1933 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1934 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1935 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1936 \-display xtest.localdomain:0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1937 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1938 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1939 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1940 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1941 .B \-double
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1942 Enables double buffering.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1943 Fixes flicker by storing two frames in memory, and displaying one while
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1944 decoding another.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1945 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
1946 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
1947 very little video memory.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1948 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1949 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1950 .B \-dr \ \ \
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1951 Turns on direct rendering (not supported by all codecs and video outputs)
13040
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1952 .br
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1953 .I WARNING:
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1954 May cause OSD/\:SUB corruption!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
1955 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1956 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1957 .B \-dxr2 <option1:option2:...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1958 This option is used to control the dxr2 video output driver.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1959 .RSs
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1960 .IPs ar-mode=<value>
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
1961 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
1962 .IPs iec958-encoded
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1963 Set iec958 output mode to encoded.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1964 .IPs iec958-decoded
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1965 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
1966 .IPs macrovision=<value>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1967 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
1968 3 = agc 4 colorstripe)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1969 .IPs mute\
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1970 mute sound output
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1971 .IPs unmute
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1972 unmute sound output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1973 .IPs ucode=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1974 path to the microcode
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1975 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1976 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1977 .sp 1
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
1978 .I TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1979 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1980 .RSs
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1981 .IPs 75ire
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1982 enable 7.5 IRE output mode
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1983 .IPs no75ire
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1984 disable 7.5 IRE output mode (default)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1985 .IPs bw\ \ \
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1986 b/\:w TV output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1987 .IPs color
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1988 color TV output (default)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1989 .IPs interlaced
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1990 interlaced TV output (default)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1991 .IPs nointerlaced
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1992 disable interlaced TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1993 .IPs norm=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1994 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
1995 .IPs square-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1996 set pixel mode to square
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1997 .IPs ccir601-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1998 set pixel mode to ccir601
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1999 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2000 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2001 .sp 1
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2002 .I overlay
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2003 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2004 .RSs
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2005 .IPs cr-left=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2006 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
2007 .IPs cr-right=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2008 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
2009 .IPs cr-top=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2010 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
2011 .IPs cr-bottom=<0\-500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2012 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
2013 .IPs ck-[r|g|b]=<0\-255>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2014 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
2015 .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
2016 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
2017 .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
2018 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
2019 .IPs ignore-cache
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2020 Ignore cached overlay settings.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2021 .IPs update-cache
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2022 Update cached overlay settings.
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2023 .IPs ol-osd
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2024 Enable overlay onscreen display.
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2025 .IPs nool-osd
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2026 Disable overlay onscreen display (default).
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2027 .IPs ol[h|w|x|y]-cor=<-20\-20>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2028 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
2029 match the window perfectly (default: 0).
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2030 .IPs overlay
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2031 Activate overlay (default).
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
2032 .IPs nooverlay
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2033 Activate TVout.
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
2034 .IPs overlay-ratio=<1\-2500>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2035 Tune the overlay (default: 1000).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2036 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2037 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
2038 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2039 .B \-fb <device> (\-vo fbdev or directfb only) (OBSOLETE)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2040 Specifies the framebuffer device to use (default: /dev/\:fb0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2041 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2042 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2043 .B \-fbmode <modename> (\-vo fbdev only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2044 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
2045 /etc/\:fb.modes.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2046 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2047 .I NOTE:
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2048 VESA framebuffer doesn't support mode changing.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2049 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2050 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2051 .B \-fbmodeconfig <filename> (\-vo fbdev only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2052 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2053 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2054 .TP
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2055 .B \-forcexv (\-vo sdl only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2056 Force using XVideo through the sdl video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2057 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2058 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2059 .B \-fs (also see \-zoom)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2060 Fullscreen playback (centers movie, and paints black bands around it).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2061 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2062 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2063 .TP
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
2064 .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
2065 Try this option if you still experience fullscreen problems.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2066 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2067 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2068 .B \-fstype <type1,type2,...> (X11 only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2069 Specify a priority list of fullscreen modes to be used.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2070 You can negate the modes by prefixing them with '\-'.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2071 If you experience problems like the fullscreen window being covered
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2072 by other windows try using a different order.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2073 .br
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2074 .I NOTE:
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2075 See \-fstype help for a full list of available modes.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2076 .sp 1
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2077 The available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2078 .sp 1
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2079 .PD 0
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
2080 .RSs
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2081 .IPs above
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2082 Use the _NETWM_STATE_ABOVE hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2083 .IPs below
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2084 Use the _NETWM_STATE_BELOW hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2085 .IPs fullscreen
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2086 Use the _NETWM_STATE_FULLSCREEN hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2087 .IPs layer
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2088 Use the _WIN_LAYER hint with the default layer.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
2089 .IPs layer=<0...15>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2090 Use the _WIN_LAYER hint with the given layer number.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2091 .IPs netwm
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2092 Force NETWM style.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2093 .IPs none\
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2094 Do not set fullscreen window layer.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2095 .IPs stays_on_top
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
2096 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2097 .REss
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2098 .sp 1
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2099 .RS
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2100 .I EXAMPLE:
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
2101 .RE
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2102 .PD 0
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2103 .RSs
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2104 .IPs layer,stays_on_top,above,fullscreen
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2105 Default order, will be used as a fallback if incorrect or
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2106 unsupported modes are specified.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2107 .IPs \-fullscreen
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2108 Fixes fullscreen switching on OpenBox 1.x.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2109 .RE
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2110 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2111 .
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
2112 .TP
8745
93f78fb709e6 Added support for X style -geometry options (adapted from Henk's patch)
mark
parents: 8708
diff changeset
2113 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2114 Adjust where the output is on the screen initially.
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2115 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
2116 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
2117 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
2118 screen size in that direction.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2119 It also supports the standard X11 \-geometry option format.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2120 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2121 .I NOTE:
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2122 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2123 directx and tdfxfb video output drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2124 .sp 1
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
2125 .I EXAMPLE:
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2126 .PD 0
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2127 .RSs
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2128 .IPs 50:40
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2129 Places the window at x=50, y=40.
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2130 .IPs 50%:50%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2131 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
2132 .IPs 100%\
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2133 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
2134 .IPs 100%:100%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
2135 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
2136 .RE
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2137 .PD 1
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2138 .
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
2139 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2140 .B \-guiwid <window\ ID> (also see \-wid) (GUI only)
9334
f6007efc714f spelling
diego
parents: 9314
diff changeset
2141 This tells the GUI to also use an X11 window and stick itself to the bottom
f6007efc714f spelling
diego
parents: 9314
diff changeset
2142 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
2143 MPlayer plugin for instance).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2144 .
9314
f38fe55d0e05 this patch adds the option -guiwid to gmplayer. I think its a more clean
arpi
parents: 9309
diff changeset
2145 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2146 .B \-hue <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2147 Adjust the hue of the video signal (default: 0).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2148 You can get a colored negative of the image with this option.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2149 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2150 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2151 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2152 .B \-monitor-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2153 Specify the dotclock or pixelclock range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2154 .
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2155 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2156 .B \-monitor-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2157 Specify the horizontal frequency range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2158 .
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2159 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2160 .B \-monitor-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
2161 Specify the vertical frequency range of the monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2162 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2163 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2164 .B \-monitoraspect <ratio> (also see \-aspect)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2165 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
2166 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
2167 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2168 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2169 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2170 \-monitoraspect 4:3 or 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2171 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2172 \-monitoraspect 16:9 or 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2173 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2174 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2175 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2176 .TP
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2177 .B \-nograbpointer
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2178 Do not grab the mouse pointer after a video mode change (\-vm).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2179 Useful for multihead setups.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2180 .
8692
604f0cde816c X11 window aspect patch by Arnaud Boulan <boulan@iie.cnam.fr>
attila
parents: 8685
diff changeset
2181 .TP
12388
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
2182 .B \-nokeepaspect
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2183 Do not keep window aspect ratio when resizing windows.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2184 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2185 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
2186 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2187 .TP
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2188 .B \-noxv (\-vo sdl only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2189 Disables using XVideo through the sdl video output driver.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2190 .
10991
e65b09eb0a2a sdl only -noxv
alex
parents: 10974
diff changeset
2191 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2192 .B \-ontop\
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2193 Makes the player window stay on top of other windows.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2194 Supported by video output drivers which use X11, except SDL,
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
2195 as well as directx and gl2.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2196 .
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
2197 .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
2198 .B \-panscan <0.0\-1.0>
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
2199 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2200 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
2201 The range controls how much of the image is cropped.
13636
a6c36a69734b vo_gl now supports -panscan as well.
diego
parents: 13635
diff changeset
2202 Only works with the xv, xmga, mga, gl and xvidix video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2203 .
6330
68a3003b57ce panscan added
gabucino
parents: 6326
diff changeset
2204 .TP
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2205 .B \-refreshrate <Hz>
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2206 Set the monitor refreshrate in Hz.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2207 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
2208 .
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2209 .TP
13005
8d37cc41a272 -rootwin is no longer X11 only.
diego
parents: 13002
diff changeset
2210 .B \-rootwin
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2211 Play movie in the root window (desktop background).
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2212 Desktop background images may cover the movie window, though.
13090
0c37bcfc5ef0 added -rootwin support to vo_directx
joey
parents: 13088
diff changeset
2213 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
2214 .
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2215 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2216 .B \-saturation <-100\-100>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2217 Adjust the saturation of the video signal (default: 0).
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2218 You can get grayscale output with this option.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2219 Not supported by all video output drivers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2220 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2221 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2222 .B \-screenh <pixels>
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2223 Specify the vertical screen resolution for video output drivers which
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2224 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
2225 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2226 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2227 .B \-screenw <pixels>
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2228 Specify the horizontal screen resolution for video output drivers which
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2229 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
2230 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2231 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2232 .B \-stop-xscreensaver (X11 only)
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2233 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
2234 .
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2235 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2236 .B \-vm \ \ \
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2237 Try to change to a different video mode.
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2238 Supported by the dga, x11, xv, sdl and directx video output drivers.
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2239 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
2240 \-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
2241 the new display mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2242 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2243 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2244 .B \-vsync \ \
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2245 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
2246 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2247 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2248 .B \-wid <window\ ID> (also see \-guiwid) (X11 only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2249 This tells MPlayer to attach to an existing X11 window.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2250 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
2251 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2252 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2253 .B \-xineramascreen <0\-...>
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2254 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2255 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
2256 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2257 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2258 .B \-z <0\-9> (\-vo png only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2259 Specifies the compression level of the png video output driver.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2260 0 is no compression, 9 is the maximum compression.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2261 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2262 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2263 .B \-zrbw (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2264 Display in black and white.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2265 For optimal performance, this can be combined with '\-lavdopts gray'.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2266 .
7192
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2267 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2268 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2269 Select a part of the input image to display, multiple occurences
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2270 of this option switch on cinerama mode.
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2271 In cinerama mode the movie is distributed over more than one TV
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2272 (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
2273 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
2274 card should at least have a \-zrdev in addition to the \-zrcrop.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2275 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
2276 documentation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2277 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2278 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2279 .B \-zrdev <device> (\-vo zr only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2280 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
2281 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
2282 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2283 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2284 .B \-zrfd (\-vo zr only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2285 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2286 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
2287 Use this option to force decimation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2288 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2289 .TP
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2290 .B \-zrhdec <1,2,4> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2291 Horizontal decimation: Ask the driver to send only every 2nd or 4th
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2292 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
2293 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
2294 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2295 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2296 .B \-zrhelp (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2297 Display a list of all \-zr* options, their default values and a
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2298 cinerama mode example.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2299 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2300 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2301 .B \-zrnorm <norm> (\-vo zr only)
13077
3a486d15217f minor fixes
wight
parents: 13076
diff changeset
2302 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
2303 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2304 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2305 .B \-zrquality <1\-20> (\-vo zr only)
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2306 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
2307 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2308 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2309 .B \-zrvdec <1,2,4> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2310 Vertical decimation: Ask the driver to send only every 2nd or 4th
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2311 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
2312 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
2313 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2314 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2315 .B \-zrxdoff <x display offset> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2316 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
2317 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
2318 .
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2319 .TP
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2320 .B \-zrydoff <y display offset> (\-vo zr only)
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
2321 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
2322 offset from the upper-left corner of the TV screen (default: centered).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2323 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2324 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2325 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2326 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2327 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
2328 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2329 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2330 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2331 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2332 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
2333 .PP
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2334 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
2335 contained in the list.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2336 Suboptions are optional and can mostly be omitted.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2337 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2338 .I NOTE:
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
2339 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
2340 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2341 .I EXAMPLE:
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 "\-vo xmga,xv,"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2345 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
2346 .IPs "\-vo directx:noaccel"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2347 Uses the DirectX driver with acceleration features turned off.
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
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2350 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2351 Available video output drivers are:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2352 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2353 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2354 .B xv (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2355 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
2356 accelerated playback.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2357 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
2358 the best option.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2359 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2360 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2361 .IPs port=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2362 Select a specific XVideo port.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2363 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2364 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2365 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2366 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2367 .B x11 (X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2368 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
2369 works whenever X11 is present.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2370 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2371 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2372 .B xover (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2373 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
2374 Currently only supported by tdfx_vid.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2375 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2376 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2377 .IPs <vo_driver>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2378 Select the driver to use as source to overlay on top of X11.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2379 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
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
13562
e1f2be2e2dfe xvmc clarification
diego
parents: 13556
diff changeset
2383 .B xvmc (X11 with \-vc ffmpeg12mc only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2384 Video output driver that uses the XvMC (X Video Motion Compensation)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2385 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
2386 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2387 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2388 .IPs benchmark
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2389 Disables image display.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2390 Necessary for proper benchmarking of drivers that change
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2391 image buffers on monitor retrace only (nVidia).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2392 .IPs queue
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2393 Queue frames for display to allow more parallel work of the video hardware.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2394 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
2395 .IPs sleep
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2396 Use sleep function while waiting for rendering to finish
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2397 (not recomended on Linux).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2398 .IPs wait\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2399 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
2400 (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2401 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2402 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2403 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2404 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2405 .B dga (X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2406 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
2407 Considered obsolete.
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
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2410 .B sdl (also see \-forcexv, \-noxv) (SDL only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2411 Highly platform independent SDL (Simple Directmedia Layer) library
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2412 video output driver.
13274
c7408a0158cc MPlayer X11 options do not affect SDL.
diego
parents: 13273
diff changeset
2413 Since SDL uses its own X11 layer, MPlayer X11 options do not have
c7408a0158cc MPlayer X11 options do not affect SDL.
diego
parents: 13273
diff changeset
2414 any effect on SDL.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2415 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2416 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2417 .IPs <driver>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2418 Explicitly choose the SDL driver to use.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2419 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2420 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2421 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2422 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2423 .B vidix\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2424 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
2425 video acceleration features of different graphics cards.
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2426 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
2427 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2428 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2429 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2430 Explicitly choose the VIDIX subdevice driver to use.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2431 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
2432 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
2433 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2434 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2435 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2436 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2437 .B xvidix (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2438 X11 frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2439 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2440 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2441 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2442 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2443 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2444 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2445 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2446 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2447 .B cvidix\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2448 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
2449 textconsole with nVidia cards.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2450 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2451 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2452 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2453 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2454 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2455 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2456 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2457 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2458 .B winvidix (Windows only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2459 Windows frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2460 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2461 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2462 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2463 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2464 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2465 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2466 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2467 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2468 .B directx (Windows only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2469 Video output driver that uses the DirectX interface.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2470 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2471 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2472 .IPs noaccel
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2473 Turns off hardware acceleration.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2474 Try this option if you have display problems.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2475 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2476 .PD 1
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 quartz (Mac OS X only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2480 Mac OS X Quartz video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2481 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
2482 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
2483 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2484 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2485 .IPs device_id=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2486 Choose the display device to use in fullscreen.
13789
0c11de3fb17a fs_res desc for vo_quartz
nplourde
parents: 13777
diff changeset
2487 .IPs fs_res=<width>:<height>
0c11de3fb17a fs_res desc for vo_quartz
nplourde
parents: 13777
diff changeset
2488 Choose the screen resolution to use in fullscreen (useful on slower system).
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2489 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2490 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2491 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2492 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2493 .B fbdev (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2494 Uses the kernel framebuffer to play video.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2495 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2496 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2497 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2498 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2499 name of the VIDIX subdevice if the device name starts with 'vidix'
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2500 (e.g.\& 'vidixsis_vid' for the sis driver).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2501 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2502 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2503 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2504 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2505 .B fbdev2 (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2506 Uses the kernel framebuffer to play video,
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2507 alternative implementation.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2508 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2509 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2510 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2511 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2512 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2513 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2514 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2515 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2516 .B vesa\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2517 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
2518 compatible card.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2519 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2520 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2521 .IPs dga\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2522 Turns on DGA mode.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2523 .IPs nodga
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2524 Turns off DGA mode.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2525 .IPs neotv_pal
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2526 Activate the NeoMagic TV out and set it to PAL norm.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2527 .IPs neotv_ntsc
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2528 Activate the NeoMagic TV out and set it to NTSC norm.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2529 .IPs vidix
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2530 Use the VIDIX driver.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2531 .IPs lvo:\ \ \
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2532 Activate the Linux Video Overlay on top of VESA mode.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2533 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2534 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2535 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2536 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2537 .B svga\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2538 Play video using the SVGA library.
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2539 .PD 0
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2540 .RSs
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2541 .IPs "<video mode>"
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2542 Specify video mode to use.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2543 The mode can be given in a <width>x<height>x<colors> format,
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2544 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2545 .IPs bbosd
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2546 Draw OSD into black bands below the movie (slower).
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2547 .IPs native
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2548 Use only native drawing functions.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2549 This avoids direct rendering, OSD and hardware acceleration.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2550 .IPs retrace
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2551 Force frame switch on vertical retrace.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2552 Usable only with \-double.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2553 It has the same effect as the \-vsync option.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2554 .IPs sq\ \ \
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2555 Try to select a video mode with square pixels.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2556 .IPs vidix
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2557 Use svga with VIDIX.
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2558 .RE
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2559 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2560 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2561 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2562 .B gl\ \ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2563 OpenGL video output driver.
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2564 Simple version, video size must be smaller than
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2565 the maximum texture size of your OpenGL implementation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2566 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
2567 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2568 .RSs
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2569 .IPs (no)manyfmts
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2570 Enables support for more (RGB and BGR) color formats.
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2571 Needs OpenGL version >= 1.2.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2572 .IPs slice-height=<0\-...>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2573 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
2574 0 for whole image.
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2575 .IPs (no)osd
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
2576 Enable or disable support for OSD rendering via OpenGL (default: enabled).
13585
db4d2cf3f2dc OpenGL OSD rendering for vo_gl
reimar
parents: 13584
diff changeset
2577 Mostly for testing, you should use \-osdlevel 0 to disable OSD.
13660
b34c5aa5f798 OSD variant for vo_gl.c that behaves more like the one of other vos.
reimar
parents: 13654
diff changeset
2578 .IPs (no)scaled-osd
13698
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2579 Changes the way the OSD behaves when the size of the
13660
b34c5aa5f798 OSD variant for vo_gl.c that behaves more like the one of other vos.
reimar
parents: 13654
diff changeset
2580 window changes (default: disabled).
13698
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2581 When enabled behaves more like the other video output drivers,
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2582 which is better for fixed-size fonts.
5e3d7843c522 wording/spelling
diego
parents: 13692
diff changeset
2583 Disabled looks much better with FreeType fonts and uses the
13660
b34c5aa5f798 OSD variant for vo_gl.c that behaves more like the one of other vos.
reimar
parents: 13654
diff changeset
2584 borders in fullscreen mode.
13601
da85ac96600e aspect scaling and panscan support for vo_gl.c
reimar
parents: 13590
diff changeset
2585 .IPs (no)aspect
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
2586 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
13601
da85ac96600e aspect scaling and panscan support for vo_gl.c
reimar
parents: 13590
diff changeset
2587 Disabling might increase speed.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2588 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2589 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2590 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2591 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2592 .B gl2\ \ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2593 OpenGL video output driver, second generation.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2594 Supports OSD and videos larger than the maximum texture size.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2595 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2596 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2597 .B null\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2598 Produces no video output.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2599 Useful for benchmarking.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2600 .
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2601 .TP
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2602 .B aa (also see \-aa*)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2603 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
2604 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2605 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2606 .B caca\ \ \
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2607 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
2608 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2609 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2610 .B bl\ \ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2611 Video playback using the Blinkenlights UDP protocol.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2612 This driver is highly hardware specific.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2613 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2614 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2615 .IPs <subdevice>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2616 Explicitly choose the Blinkenlights subdevice driver to use.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2617 It's something like arcade:host=localhost:2323 or
13412
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
2618 hdl:file=name1,file=name2.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2619 You must specify a subdevice.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2620 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2621 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2622 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2623 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2624 .B ggi\ \ \ \
13096
c6c1dc9d0550 small fixes
diego
parents: 13090
diff changeset
2625 GGI graphics system video output driver
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2626 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2627 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2628 .IPs <driver>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2629 Explicitly choose the GGI driver to use.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2630 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2631 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2632 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2633 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2634 .B directfb
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2635 Play video using the DirectFB library.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2636 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2637 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2638 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2639 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
2640 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2641 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
2642 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
2643 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2644 Single buffering should be avoided (default: single).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2645 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2646 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2647 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
2648 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
2649 like most MPEG movies are.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2650 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
2651 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2652 .IPs layer=N
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
2653 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
2654 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2655 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2656 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2657 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2658 .B dfbmga\
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2659 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
2660 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
2661 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
2662 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2663 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2664 .IPs (no)bes
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2665 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
2666 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
2667 picture processing is done in hardware.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2668 Works only on the primary head.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2669 .IPs (no)spic
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2670 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
2671 .IPs (no)crtc2
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2672 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
2673 The output quality is amazing as it's a full interlaced picture
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2674 with proper sync to every odd/\:even field.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2675 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2676 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
2677 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2678 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
2679 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
2680 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2681 Single buffering should be avoided (default: triple).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2682 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2683 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2684 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
2685 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
2686 like most MPEG movies are.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2687 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
2688 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2689 .IPs tvnorm=pal|ntsc|auto
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2690 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
2691 for modifying /etc/\:directfbrc (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2692 Valid norms are pal = PAL, ntsc = NTSC.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2693 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2694 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
2695 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2696 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2697 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2698 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2699 .B mga (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2700 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
2701 end scaler on Gxxx cards through a kernel module.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2702 If you have a Matrox card, this is the fastest option.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2703 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2704 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2705 .IPs <device>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2706 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2707 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2708 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2709 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2710 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2711 .B xmga (Linux, X11 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2712 The mga video output driver, running in an X11 window.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2713 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2714 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2715 .IPs <device>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2716 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2717 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2718 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2719 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2720 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2721 .B syncfb\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2722 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
2723 special hardware features of Matrox Gxxx cards like hardware
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2724 deinterlacing, scaling and synchronizing your video output to
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2725 the vertical retrace of your monitor.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2726 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2727 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2728 .B 3dfx (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2729 3Dfx specific video output driver.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2730 This driver directly uses the 3Dfx hardware on top of X11.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2731 Only 16 bpp are supported.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2732 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2733 .
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2734 .TP
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2735 .B tdfxfb (Linux only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2736 This driver employs the tdfx framebuffer driver to play movies with
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2737 YUV acceleration on 3Dfx cards.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2738 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2739 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2740 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2741 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2742 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2743 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2744 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2745 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2746 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2747 .B tdfx_vid (Linux only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2748 3Dfx specific video output driver.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2749 This driver directly uses the tdfx_vid kernel module.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2750 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2751 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2752 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2753 .IPs <device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2754 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2755 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2756 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2757 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2758 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2759 .B dxr2 (also see \-dxr2) (DXR2 only)
13088
e624cc4fc290 spelling/wording as suggested by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13085
diff changeset
2760 Creative DXR2 specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2761 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2762 .RSs
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2763 .IPs <vo_driver>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2764 Output video subdriver to use as overlay (x11, xv).
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2765 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2766 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2767 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2768 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2769 .B dxr3 (DXR3 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2770 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
2771 Hollywood Plus) specific video output driver.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2772 Also see the lavc video filter.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2773 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2774 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2775 .IPs overlay
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2776 Activates the overlay instead of TVOut.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2777 .IPs prebuf
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2778 Turns on prebuffering.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2779 .IPs sync\
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2780 Will turn on the new sync-engine.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2781 .IPs norm=<norm>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2782 Specifies the TV norm.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2783 .RSss
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2784 0: Does not change current norm (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2785 .br
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2786 1: Auto-adjust using PAL/\:NTSC.
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2787 .br
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2788 2: Auto-adjust using PAL/\:PAL-60.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2789 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2790 3: PAL
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2791 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2792 4: PAL-60
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2793 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2794 5: NTSC
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2795 .REss
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2796 .IPs <0\-3>
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2797 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
2798 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2799 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2800 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2801 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2802 .B mpegpes (DVB only)
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2803 Video output driver for DVB cards that writes the output to an MPEG-PES file
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2804 if no DVB card is installed.
13049
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2805 .PD 0
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2806 .RSs
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2807 .IPs card=<1\-4>
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2808 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
2809 (V3 API only, such as 1.x.y series drivers).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2810 .IPs <filename>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2811 Allows specifying the output filename (default: ./grab.mpg).
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2812 .RE
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2813 .PD 1
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2814 .
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2815 .TP
13639
12028d59e650 10l to me, noticed by Torinthiel
diego
parents: 13638
diff changeset
2816 .B zr (also see \-zr* and \-zrhelp)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2817 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
2818 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2819 .TP
13639
12028d59e650 10l to me, noticed by Torinthiel
diego
parents: 13638
diff changeset
2820 .B zr2 (also see the zrmjpeg video filter)
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2821 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
2822 second generation.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2823 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2824 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2825 .IPs dev=<device>
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2826 Specifies the device to use.
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2827 .IPs pal\ \
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2828 Activate PAL video norm.
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2829 .IPs secam
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2830 Activate SECAM video norm.
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2831 .IPs ntsc\
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2832 Activate NTSC video norm.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2833 .IPs prebuf
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2834 Activate prebuffering, not yet supported.
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2835 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2836 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2837 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2838 .TP
13412
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
2839 .B md5sum\
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2840 Calculate MD5 sums of each frame and write them to a file.
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2841 Supports RGB24 and YV12 colorspaces.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2842 Useful for debugging.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2843 .PD 0
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2844 .RSs
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2845 .IPs outfile=<value>
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2846 Specify the output filename (default: ./md5sums).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2847 .RE
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2848 .PD 1
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2849 .
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2850 .TP
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2851 .B yuv4mpeg
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2852 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
2853 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
2854 directory.
13107
5f58b31a706f vo_svga suboptions, yuv4mpeg note
diego
parents: 13104
diff changeset
2855 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
2856 useful if you want to process the video with the mjpegtools suite.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2857 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format.
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2858 .PD 0
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2859 .RSs
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2860 .IPs interlaced
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2861 Write the output as interlaced frames, top field first.
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2862 .IPs interlaced_bf
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2863 Write the output as interlaced frames, bottom field first.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2864 .REss
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2865 .PD 1
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2866 .RS
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2867 .sp 1
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2868 .I NOTE:
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
2869 If you don't specify any option the output is progressive
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
2870 (i.e.\& not interlaced).
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2871 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2872 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2873 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2874 .B gif89a\
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2875 Output each frame into a single animated GIF file in the current directory.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2876 It supports only RGB format with 24 bpp and the output is converted to 256
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2877 colors.
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2878 .PD 0
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2879 .RSs
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
2880 .IPs <fps>
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2881 Float value to specify framerate (default: 5.0).
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2882 .IPs <filename>
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2883 Specify the output filename (default: ./out.gif).
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2884 .REss
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2885 .PD 1
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2886 .RS
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2887 .sp 1
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2888 .I NOTE:
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2889 You must specify the framerate before the filename or the framerate will
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2890 be part of the filename.
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2891 .sp 1
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2892 .I EXAMPLE:
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2893 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2894 .PD 0
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2895 .RSs
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2896 mplayer video.nut \-vo gif89a:15.0:test.gif
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2897 .RE
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2898 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2899 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2900 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2901 .B jpeg\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2902 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
2903 Each file takes the frame number padded with leading zeros as name.
13247
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2904 .PD 0
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2905 .RSs
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2906 .IPs [no]progressive
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2907 Specify standard or progressive JPEG (default: noprogressive).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2908 .IPs [no]baseline
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2909 Specify use of baseline or not (default: baseline).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2910 .IPs optimize=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2911 optimization factor (default: 100)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2912 .IPs smooth=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2913 smooth factor (default: 0)
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2914 .IPs quality=<0\-100>
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2915 quality factor (default: 75)
13432
ca0cf56c02d2 fixes, better wordings on the new portable anymap and md5sum video output
gpoirier
parents: 13431
diff changeset
2916 .IPs outdir=<dirname>
13452
c364b7c13dd8 Same wording of vo_jpeg's outdir option as vo_pnm's.
ivo
parents: 13446
diff changeset
2917 Specify the directory to save the JPEG files to (default: ./).
13494
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2918 .IPs subdirs=<prefix>
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2919 Create numbered subdirectories with the specified prefix to
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2920 save the files in instead of the current directory.
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2921 .IPs maxfiles=<value> (subdirs only)
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2922 Maximum number of files to be saved per subdirectory.
13247
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2923 Must be equal to or larger than 1 (default: 1000).
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2924 .RE
933b45ad31d5 Removal of -jpeg commandline option.
ivo
parents: 13245
diff changeset
2925 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2926 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2927 .TP
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2928 .B pnm\ \ \ \
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2929 Output each frame into a PNM file in the current directory.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2930 Each file takes the frame number padded with leading zeros as name.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2931 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2932 Also see pnm(5), ppm(5) and pgm(5).
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2933 .PD 0
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2934 .RSs
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2935 .IPs ppm
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2936 Write PPM files (default).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2937 .IPs pgm
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2938 Write PGM files.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2939 .IPs pgmyuv
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2940 Write PGMYUV files.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2941 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2942 bottom of the picture.
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2943 .IPs raw
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2944 Write PNM files in raw mode (default).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2945 .IPs ascii
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2946 Write PNM files in ASCII mode.
13432
ca0cf56c02d2 fixes, better wordings on the new portable anymap and md5sum video output
gpoirier
parents: 13431
diff changeset
2947 .IPs outdir=<dirname>
ca0cf56c02d2 fixes, better wordings on the new portable anymap and md5sum video output
gpoirier
parents: 13431
diff changeset
2948 Specify the directory to save the PNM files to (default: ./).
13468
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2949 .IPs subdirs=<prefix>
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2950 Create numbered subdirectories with the specified prefix to
d9591400424b Hint at examples, better wording, some cosmetics.
diego
parents: 13463
diff changeset
2951 save the files in instead of the current directory.
13494
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2952 .IPs maxfiles=<value> (subdirs only)
c78b1c7cc818 identical text for identical suboptions
diego
parents: 13493
diff changeset
2953 Maximum number of files to be saved per subdirectory.
13400
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2954 Must be equal to or larger than 1 (default: 1000).
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2955 .RE
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2956 .PD 1
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2957 .
a06b071fa157 Document the new portable anymap and md5sum video output drivers.
ivo
parents: 13389
diff changeset
2958 .TP
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2959 .B png (also see \-z)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2960 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
2961 Each file takes the frame number padded with leading zeros as name.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2962 24bpp RGB and BGR formats are supported.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2963 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2964 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2965 .B tga\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2966 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
2967 Each file takes the frame number padded with leading zeros as name.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2968 The purpose of this video output driver is to have a simple lossless
13309
4bb3c84f948e Video driver null, yuv4mpeg, gif89a, pgm, png and tga documented, jpeg drop from the list to document
danny
parents: 13293
diff changeset
2969 image writer to use without any external library.
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
2970 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2971 You can force a particular format with the format video filter.
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2972 .sp 1
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2973 .I EXAMPLE:
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2974 .RE
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2975 .PD 0
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2976 .RSs
13328
f0f14bcbfce7 All video driver suboptions documented, gif and tga examples
danny
parents: 13327
diff changeset
2977 mplayer video.nut \-vf format=bgr15 \-vo tga
13318
f2062c2655ad fixes some typos, wording and formatting
kraymer
parents: 13313
diff changeset
2978 .RE
13319
1709e2449b64 hopefully last format correction regarding prior commit in video output drivers section
kraymer
parents: 13318
diff changeset
2979 .PD 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2980 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2981 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2982 .
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
2983 .SH "DECODING/\:FILTERING OPTIONS"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
2984 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2985 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2986 .B \-ac <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2987 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
2988 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2989 Use a '-' before the codec name to omit it.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
2990 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
2991 contained in the list.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2992 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2993 .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
2994 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
2995 .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
2996 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2997 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2998 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2999 .IPs "\-ac mp3acm"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3000 Force the l3codeca.acm MP3 codec.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3001 .IPs "\-ac mad,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3002 Try libmad first, then fall back on others.
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
3003 .IPs "\-ac hwac3,a52,"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3004 Try hardware AC3 passthrough, software AC3, then others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3005 .IPs "\-ac -ffmp3,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3006 Skip FFmpeg's MP3 decoder.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3007 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3008 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3009 .
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
3010 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3011 .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
3012 Activate a comma separated list of audio filters and their options.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3013 Also see the audio filters section of the documentation.
13269
aa13937da8a0 mplayer -af help now lists all available audio filters.
ivo
parents: 13267
diff changeset
3014 .br
aa13937da8a0 mplayer -af help now lists all available audio filters.
ivo
parents: 13267
diff changeset
3015 .I NOTE:
aa13937da8a0 mplayer -af help now lists all available audio filters.
ivo
parents: 13267
diff changeset
3016 To get a full list of available audio filters, see \-af help.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3017 .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
3018 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
3019 .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
3020 .IPs resample[=srate[:sloppy][:type]]
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3021 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
3022 It only supports the 16-bit little-endian format.
13732
cf89f6f60922 MEncoder needs -srate together with -af resample,
diego
parents: 13726
diff changeset
3023 With MEncoder, you need to also use \-srate <srate>.
13777
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3024 .IPs lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3025 Changes the sample rate of the audio stream to an integer srate in Hz.
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3026 It only supports the 16-bit little-endian format.
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3027 With MEncoder, you need to also use \-srate <srate>.
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3028 .RSss
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3029 srate: the output sample rate
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3030 .br
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3031 length: length of the filter with respect to the lower sampling rate
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3032 default: 16
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3033 .br
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3034 linear: if 1 then filters will be linearly interpolated between polyphase
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3035 entries
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3036 .br
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3037 count: log2 of the number of polyphase entries
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3038 (..., 10->1024, 11->2048, 12->4096, ...)
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3039 default: 10->1024
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3040 .br
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3041 cutoff: cutoff frequency (0.0-1.0), default set depending upon filter length
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3042 .REss
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3043 .IPs sweep[=speed]
50b4c7da30b5 lavcresample & sweep filters
michael
parents: 13732
diff changeset
3044 sine sweep
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3045 .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
3046 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
3047 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
3048 empty channels are inserted (except when mixing from mono to stereo, then
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3049 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
3050 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
3051 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
3052 .IPs format[=bps:f]
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3053 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
3054 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
3055 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
3056 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
3057 .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
3058 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
3059 .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
3060 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
3061 .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
3062 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
3063 .br
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
3064 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
3065 .br
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3066 .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
3067 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
3068 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
3069 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
3070 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3071 v: Sets the desired gain in dB for all channels in the stream
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3072 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
3073 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
3074 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3075 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
3076 .REss
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
3077 .IPs pan[=n:l01:l02:...l10:l11:l12:...ln0:ln1:ln2:...]
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3078 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
3079 .RSss
13245
35a69552ea80 af_pan wants number of _input_ channels, fixes bugzilla bug #22
reimar
parents: 13241
diff changeset
3080 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
3081 .br
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3082 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
3083 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3084 .IPs sub[=fc:ch]
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3085 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
3086 .RSss
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3087 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
3088 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3089 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
3090 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3091 .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
3092 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
3093 .RSss
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3094 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
3095 .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
3096 .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
3097 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
3098 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
3099 number between 0 and 1000).
11366
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
3100 .IPs export[=mmapped_file[:nsamples]]
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
3101 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
3102 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3103 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
3104 .br
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
3105 nsamples: number of samples per channel (default: 512)
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
3106 .REss
13590
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3107 .IPs extrastereo[=mul]
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3108 Increases the difference between left and right channels to add some
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3109 sort of "live" effect to playback.
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3110 .RSss
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3111 mul: difference coefficient (default: 2.5)
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3112 .REss
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3113 .IPs volnorm
93fae534ae55 af_extrastereo, af_volnorm
diego
parents: 13589
diff changeset
3114 Maximizes the volume without distorting the sound.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3115 .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
3116 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3117 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3118 .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
3119 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
3120 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3121 .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
3122 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
3123 .RSss
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3124 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
3125 .br
13079
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3126 1: Optimize for accuracy.
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3127 .br
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3128 2: Optimize for speed.
9f953243f4a7 small fixes by Sebastian Krmer <mail@skraemer.de>
diego
parents: 13077
diff changeset
3129 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3130 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
3131 .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
3132 .IPs list=<filters>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3133 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
3134 .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
3135 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
3136 .TP
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3137 .B \-afm <driver1,driver2,...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3138 Specify a priority list of audio codec families to be used, according
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3139 to their codec name in codecs.conf.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3140 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
3141 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3142 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3143 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
3144 .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
3145 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3146 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3147 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3148 .IPs "\-afm ffmpeg"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3149 Try FFmpeg's libavcodec codecs first.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3150 .IPs "\-afm acm,dshow"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3151 Try Win32 codecs first.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3152 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3153 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3154 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3155 .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
3156 .B \-aspect <ratio>
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3157 Override movie aspect ratio.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3158 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
3159 .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
3160 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3161 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3162 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3163 \-aspect 4:3 or \-aspect 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3164 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3165 \-aspect 16:9 or \-aspect 1.7777
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
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
3170 .B \-noaspect
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
3171 Disable automatic movie aspect ratio compensation.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3172 .
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
3173 .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
3174 .B \-flip \
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3175 Flip image upside-down.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3176 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3177 .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
3178 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3179 Specify libavcodec decoding parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3180 .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
3181 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3182 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3183 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3184 \-lavdopts bug=1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3185 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3186 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3187 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
3188 .RS
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3189 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
3190 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3191 .RSs
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3192 .IPs bug=<value>
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3193 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
3194 .RSss
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3195 0: nothing
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3196 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3197 1: autodetect bugs (default)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3198 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3199 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3200 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3201 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3202 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3203 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3204 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3205 16 (mpeg4): padding bug (autodetected)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3206 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3207 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3208 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3209 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3210 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3211 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3212 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3213 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3214 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3215 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3216 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3217 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3218 .REss
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3219 .IPs debug=<value>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3220 debug:
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3221 .RSss
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3222 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3223 0: disabled
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3224 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3225 1: picture info
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3226 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3227 2: rate control
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3228 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3229 4: bitstream
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3230 .br
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3231 8: macroblock (MB) type
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3232 .br
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
3233 16: quantization parameter (QP)
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3234 .br
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3235 32: motion vector
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3236 .br
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3237 0x0040: motion vector visualization (use \-noslices)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3238 .br
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
3239 0x0080: macroblock (MB) skip
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3240 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3241 0x0100: startcode
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3242 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3243 0x0200: PTS
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3244 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3245 0x0400: error resilience
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3246 .br
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3247 0x0800: memory management control operations (H.264)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3248 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3249 0x1000: bugs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
3250 .REss
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3251 .IPs ec=<value>
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3252 error concealment:
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3253 .RSss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3254 1: Use strong deblock filter for damaged MBs.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3255 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3256 2: iterative motion vector (MV) search (slow)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3257 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3258 3: all (default)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3259 .REss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3260 .IPs er=<value>
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3261 error resilience:
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3262 .RSss
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3263 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3264 0: disabled
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3265 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3266 1: careful (Should work with broken encoders.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3267 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3268 2: normal (default) (Works with compliant encoders.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3269 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3270 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3271 .br
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3272 4: very aggressive
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3273 .REss
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3274 .IPs fast\
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3275 Enable optimizations which do not comply to the specification and might
13261
42992a398551 -lavdopts fast, small fix to -lavdopts ec
diego
parents: 13260
diff changeset
3276 potentially cause problems, like simpler dequantization, assuming use
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3277 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
3278 checks to detect damaged bitstreams.
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3279 .IPs gray\
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3280 grayscale only decoding (a bit faster than with color)
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3281 .IPs "idct=<0\-99> (see \-lavcopts)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
3282 For best decoding quality use the same IDCT algorithm for decoding and encoding.
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3283 This may come at a price in accuracy, though.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
3284 .IPs lowres=<number>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
3285 Decode at lower resolutions.
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
3286 Low resolution decoding is not supported by all codecs, and it will
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
3287 often result in ugly artifacts.
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
3288 This is not a bug, but a side effect of not decoding at full resolution.
13476
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3289 .RSss
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3290 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3291 0: disabled
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3292 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3293 1: 1/2 resolution
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3294 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3295 2: 1/4 resolution
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3296 .br
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3297 3: 1/8 resolution
224f9bc2aade -lavdopts lowres
michael
parents: 13472
diff changeset
3298 .REss
13260
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3299 .IPs "sb=<number> (MPEG2 only)"
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3300 Skip the given number of macroblock rows at the bottom.
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3301 .IPs "st=<number> (MPEG2 only)"
cf4c3b32c4d7 alphabetical order for lavdopts
diego
parents: 13259
diff changeset
3302 Skip the given number of macroblock rows at the top.
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3303 .IPs vismv=<value>
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3304 vismv:
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3305 .RSss
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3306 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3307 0: disabled
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3308 .br
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3309 1: Visualize forward predicted MVs of P-frames.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3310 .br
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3311 2: Visualize forward predicted MVs of B-frames.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3312 .br
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
3313 4: Visualize backward predicted MVs of B-frames.
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
3314 .REss
13036
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
3315 .IPs vstats
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
3316 Prints some statistics and stores them in ./vstats_*.log.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3317 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3318 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3319 .TP
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3320 .B \-noslices
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3321 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
3322 whole frame in a single run.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3323 May be faster or slower, depending on card/\:cache.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3324 It has effect only with libmpeg2 and libavcodec codecs.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3325 .
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
3326 .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
3327 .B \-nosound
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3328 Do not play/\:encode sound.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
3329 Useful for benchmarking.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3330 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3331 .TP
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3332 .B \-novideo
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3333 Do not play/\:encode video.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3334 .
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
3335 .TP
13064
879c0f31f7de man page review part IV
diego
parents: 13058
diff changeset
3336 .B \-oldpp <quality> (OpenDivX only) (OBSOLETE)
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3337 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
3338 Superseded by \-pp, the internal postprocessing offers better
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3339 quality and performance.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3340 The valid range of \-oldpp values varies by codec, it is mostly
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3341 0\-6, where 0=disable, 6=slowest/\:best.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3342 .
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
3343 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3344 .B \-pp <quality> (also see \-vf pp)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3345 Set the DLL postprocess level.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3346 This option is no longer usable with \-vf pp.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3347 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3348 The valid range of \-pp values varies by codec, it is mostly
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3349 0\-6, where 0=disable, 6=slowest/\:best.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3350 .
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
3351 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3352 .B \-pphelp (also see \-vf pp)
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
3353 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
3354 .
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
3355 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
3356 .B \-ssf <mode>
13363
43e295a7c05d wording, spelling and small fixes to the video output driver section
diego
parents: 13340
diff changeset
3357 Specifies software scaler parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3358 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3359 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3360 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3361 .RSs
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3362 \-vf scale \-ssf lgb=3.0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3363 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3364 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3365 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3366 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3367 .IPs lgb=<0\-100>
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3368 gaussian blur filter (luma)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3369 .IPs cgb=<0\-100>
13327
a614fe71ad74 small fixes
diego
parents: 13325
diff changeset
3370 gaussian blur filter (chroma)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3371 .IPs ls=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3372 sharpen filter (luma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3373 .IPs cs=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3374 sharpen filter (chroma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3375 .IPs chs=<h>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3376 chroma horizontal shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3377 .IPs cvs=<v>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3378 chroma vertical shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3379 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3380 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3381 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
3382 .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
3383 .B \-stereo <mode>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3384 Select type of MP2/\:MP3 stereo output.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3385 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3386 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3387 .IPs 0
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3388 stereo
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3389 .IPs 1
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3390 left channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3391 .IPs 2
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3392 right channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3393 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3394 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3395 .
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
3396 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3397 .B \-sws <software\ scaler\ type> (also see \-vf scale and \-zoom)
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3398 Specify the software scaler algorithm to be used with the \-zoom option.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3399 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3400 .sp 1
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3401 Available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3402 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3403 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3404 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3405 .IPs 0
13492
51c46db54bd2 Sws default setting correction, and random wordings
gpoirier
parents: 13487
diff changeset
3406 fast bilinear
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3407 .IPs 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3408 bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3409 .IPs 2
13492
51c46db54bd2 Sws default setting correction, and random wordings
gpoirier
parents: 13487
diff changeset
3410 bicubic (good quality) (default)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3411 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3412 experimental
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3413 .IPs 4
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3414 nearest neighbour (bad quality)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3415 .IPs 5
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3416 area
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3417 .IPs 6
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3418 luma bicubic / chroma bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3419 .IPs 7
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3420 gauss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3421 .IPs 8
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3422 sincR
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3423 .IPs 9
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3424 lanczos
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3425 .IPs 10
13373
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3426 natural bicubic spline
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3427 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3428 .PD 1
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3429 .sp 1
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3430 .RS
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3431 .I NOTE:
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3432 For \-sws\ 2 and 7, sharpness can be set with the scaling parameter
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3433 of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, the scaling
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3434 parameter specifies the filter length (1 \- 10).
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3435 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3436 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3437 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
3438 .B \-vc <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3439 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
3440 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3441 Use a '-' before the codec name to omit it.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3442 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
3443 contained in the list.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3444 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3445 .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
3446 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
3447 .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
3448 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3449 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3450 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3451 .IPs "\-vc divx"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3452 Force Win32/\:VFW DivX codec, no fallback.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3453 .IPs "\-vc divx4,"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3454 Try divx4linux codec first, then fall back on others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3455 .IPs "\-vc -divxds,-divx,"
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3456 Skip Win32 DivX codecs.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
3457 .IPs "\-vc ffmpeg12,mpeg12,"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3458 Try libavcodec's MPEG1/\:2 codec, then libmpeg2, then others.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3459 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3460 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3461 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3462 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3463 .B \-vfm <driver1,driver2,...>
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3464 Specify a priority list of video codec families to be used, according
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
3465 to their names in codecs.conf.
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3466 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
3467 .br
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3468 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3469 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
3470 .sp 1
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3471 .I EXAMPLE:
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3472 .PD 0
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3473 .RSs
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3474 .IPs "\-vfm ffmpeg,dshow,vfw"
13184
b498729e5348 fall back to --> fall back on, some consistency
diego
parents: 13180
diff changeset
3475 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
3476 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
3477 .IPs "\-vfm xanim"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
3478 Try XAnim codecs first.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3479 .RE
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3480 .PD 1
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3481 .
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
3482 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
3483 .B \-x <x> (MPlayer only)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3484 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
3485 Disables aspect calculations.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3486 .
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
3487 .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
3488 .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
3489 Specify additional parameters when decoding with XviD.
13654
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3490 .br
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3491 .I NOTE:
13692
1d13a5d9c166 lavc is faster than XviD and thus recommended for decoding and PP.
diego
parents: 13691
diff changeset
3492 Since libavcodec is faster than XviD you might want to use the libavcodec
1d13a5d9c166 lavc is faster than XviD and thus recommended for decoding and PP.
diego
parents: 13691
diff changeset
3493 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
13654
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3494 .sp 1
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3495 XviD's internal postprocessing filters:
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3496 .PD 0
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3497 .RSs
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3498 .IPs deblock-chroma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3499 chroma deblock filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3500 .IPs deblock-luma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3501 luma deblock filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3502 .IPs dering-luma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3503 luma deringing filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3504 .IPs dering-chroma (also see \-vf pp)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3505 chroma deringing filter
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3506 .IPs filmeffect (also see \-vf noise)
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3507 Adds artificial film grain to the video.
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3508 May increase perceived quality, while lowering true quality.
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3509 .RE
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3510 .sp 1
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3511 .RS
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3512 rendering methods:
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3513 .RE
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3514 .PD 0
fe1282bdee25 Documents two new postprocessing options: "dering-luma" and "dering-chroma"
gpoirier
parents: 13648
diff changeset
3515 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3516 .IPs dr2\ \
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3517 Activate direct rendering method 2.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3518 .IPs nodr2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3519 Deactivate direct rendering method 2.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3520 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3521 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3522 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
3523 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3524 .B \-xy <value>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3525 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3526 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3527 .IPs value<=8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3528 Scale image by factor <value>.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3529 .IPs value>8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3530 Set width to value and calculate height to keep correct aspect ratio.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3531 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3532 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3533 .
6310
eda1e909a3bf -stop_xscreensaver option
diego
parents: 6268
diff changeset
3534 .TP
12731
150b7272da1b typos pointed out by Sebastian Krmer <mail@skraemer.de>
diego
parents: 12716
diff changeset
3535 .B \-y <y> (MPlayer only)
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3536 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
3537 Disables aspect calculations.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3538 .
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
3539 .TP
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3540 .B \-zoom\ \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3541 Allow software scaling, where available.
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3542 Can be used to force scaling with \-vf scale.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3543 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
3544 .I NOTE:
13211
4a4b1e77425e man page review part VI
diego
parents: 13210
diff changeset
3545 \-vf scale will ignore \-x / \-y / \-xy / \-fs / \-aspect without
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
3546 \-zoom.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3547 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3548 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3549 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3550 .SH "VIDEO FILTERS"
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3551 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
3552 The syntax is:
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3553 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3554 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3555 .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
3556 Setup a chain of video filters.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3557 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3558 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3559 .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
3560 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
3561 .B reverse
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3562 order.
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
3563 Deprecated in favor of \-vf.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3564 .PP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3565 Many parameters are optional and set to default values if omitted.
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3566 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
3567 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
3568 from the upper left corner of the bigger image.
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3569 .br
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3570 .I NOTE:
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3571 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
3572 .sp 1
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3573 Filters are managed in lists.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3574 There are a few commands to manage the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3575 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3576 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3577 .B \-vf-add <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3578 Appends the filters given as arguments to the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3579 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3580 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3581 .B \-vf-pre <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3582 Prepends the filters given as arguments to the filter list.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3583 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3584 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3585 .B \-vf-del <index1[,index2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3586 Deletes the filters at the given indexes.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3587 Index numbers start at 0, negative numbers address the end of the
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3588 list (-1 is the last).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3589 .
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3590 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3591 .B \-vf-clr
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3592 Completely empties the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3593 .PP
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3594 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
3595 .
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3596 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3597 .B \-vf <filter>=help
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3598 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
3599 filter.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3600 .
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3601 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3602 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3603 Sets a named parameter to the given value.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3604 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
3605 .PP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3606 Available filters are:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3607 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3608 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3609 .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
3610 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
3611 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
3612 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3613 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3614 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3615 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
3616 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3617 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
3618 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3619 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3620 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3621 .TP
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3622 .B cropdetect[=limit:round]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3623 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
3624 to stdout.
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3625 .PD 0
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3626 .RSs
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3627 .IPs limit
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3628 Threshold, which can be optionally specified from nothing (0) to
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3629 everything (255) (default: 24).
13205
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3630 .br
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3631 .IPs round
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3632 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
3633 The offset is automatically adjusted to center the video.
13210
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3634 Use 2 to get only even dimensions (needed for 4:2:2 video).
2a5fbe296576 cropdetect style fixup
diego
parents: 13208
diff changeset
3635 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
3636 .RE
08bb01a9905a Adds rounding parameter for width and height values returned.
reimar
parents: 13184
diff changeset
3637 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3638 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3639 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3640 .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
3641 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
3642 that takes two parameters.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3643 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3644 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3645 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3646 width and height (default: -1, maximum possible width where boundaries
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3647 are still visible.)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3648 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3649 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
3650 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3651 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3652 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3653 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3654 .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
3655 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
3656 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
3657 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
3658 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3659 .IPs w,h
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3660 Expanded width,height (default: original width,height).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3661 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
3662 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3663 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3664 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3665 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3666 .IP expand=0:-50:0:0
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3667 Adds a 50 pixel border to the bottom of the picture.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3668 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3669 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3670 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3671 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
3672 .IPs o
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3673 OSD/\:subtitle rendering
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3674 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3675 0: disable (default)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3676 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3677 1: enable
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3678 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3679 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3680 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3681 .TP
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3682 .B flip (also see \-flip)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3683 Flips the image upside down.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3684 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3685 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3686 .B mirror\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3687 Mirrors the image on the Y axis.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3688 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3689 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3690 .B rotate[=<0\-7>]
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3691 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
3692 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
3693 portrait and not landscape.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3694 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3695 .TP
13373
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3696 .B scale[=w:h[:interlaced[:chr_drop[:param[:param2[:presize]]]]]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3697 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3698 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
3699 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3700 .IPs <w>,<h>
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3701 scaled width/\:height (default: original width/\:height)
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3702 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3703 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3704 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
3705 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
3706 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3707 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
3708 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3709 -1: original width/\:height
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3710 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3711 -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
3712 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3713 -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
3714 .REss
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3715 .IPs <interlaced>
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3716 Toggle interlaced scaling.
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3717 .RSss
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3718 0: off (default)
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3719 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3720 1: on
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3721 .REss
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3722 .IPs <chr_drop>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3723 chroma skipping
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3724 .RSss
13313
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3725 0: Use all available input lines for chroma.
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3726 .br
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3727 1: Use only every 2. input line for chroma.
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3728 .br
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3729 2: Use only every 4. input line for chroma.
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3730 .br
2c19d3d8a5fb minor changes I came across during sync of videofilters section
kraymer
parents: 13309
diff changeset
3731 3: Use only every 8. input line for chroma.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3732 .REss
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3733 .IPs "<param>[:<param2>] (also see \-sws)"
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3734 Set some scaling parameters depending on the type of scaler selected
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3735 with \-sws.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3736 .RSss
13373
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3737 \-sws 2 (bicubic): B (blurring) and C (ringing)
6bd869a18d2c passing an array or double precission parameters for the scaling function, instead of missusing a few bits of the flags
michael
parents: 13368
diff changeset
3738 .br
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3739 0.00:0.60 default
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3740 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3741 0.00:0.75 VirtualDubs "precise bicubic"
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3742 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3743 0.00:0.50 Catmull-Rom spline
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3744 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3745 0.33:0.33 Mitchell-Netravali spline
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3746 .br
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
3747 1.00:0.00 cubic B-spline
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3748 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3749 \-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
3750 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3751 \-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
3752 .REss
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3753 .IPs <presize>
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3754 Scale to preset sizes.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3755 .RSss
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3756 qntsc: 352x240 (NTSC quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3757 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3758 qpal: 352x288 (PAL quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3759 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3760 ntsc: 720x480 (standard NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3761 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3762 pal: 720x576 (standard PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3763 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3764 sntsc: 640x480 (square pixel NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3765 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3766 spal: 768x576 (square pixel PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3767 .REss
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3768 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3769 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3770 .TP
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3771 .B dsize=[aspect|w:h]
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3772 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
3773 filter chain.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3774 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
3775 (1.33).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3776 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
3777 desired.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3778 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
3779 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
3780 correct aspect.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3781 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3782 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3783 .B yuy2\ \ \
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3784 Forces software YV12/\:I420/\:422P to YUY2 conversion.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3785 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
3786 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3787 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3788 .B yvu9\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3789 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
3790 Deprecated in favor of the software scaler.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3791 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3792 .TP
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3793 .B yuvcsp\
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3794 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
3795 .
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3796 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3797 .B rgb2bgr[=swap]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3798 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
3799 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3800 .RSs
12559
diego
parents: 12558
diff changeset
3801 .IPs swap\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3802 Also perform R <\-> B swapping.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3803 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3804 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3805 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3806 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3807 .B palette
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3808 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
3809 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3810 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3811 .B format[=fourcc]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3812 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
3813 Use together with the scale filter for a real conversion.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3814 .br
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3815 .I NOTE:
11313
b4fad475a89d Add -vf format=fmt=help hint.
diego
parents: 11302
diff changeset
3816 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
3817 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3818 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3819 .IPs fourcc
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3820 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
3821 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3822 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3823 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3824 .TP
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3825 .B noformat[=fourcc]
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3826 Restricts the colorspace for the next filter without doing any conversion.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3827 Unlike the format filter, this will allow any colorspace
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3828 .B except
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3829 the one you specify.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3830 .br
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3831 .I NOTE:
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3832 For a list of available formats see noformat=fmt=help.
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3833 .PD 0
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3834 .RSs
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3835 .IPs fourcc
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3836 format name like rgb15, bgr24, yv12, etc (default: yv12)
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3837 .RE
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3838 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3839 .
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3840 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
3841 .B pp[=filter1[:option1[:option2...]]/\:[-]filter2...] (also see \-pphelp)
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3842 Enables the specified chain of postprocessing subfilters.
13412
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
3843 Subfilters must be separated by '/' and can be disabled by
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
3844 prepending a '\-'.
c8fcff5c2c24 Cosmetics, start new sentences on a new line.
diego
parents: 13407
diff changeset
3845 A subfilter's scope can be determined by appending a ':' followed
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
3846 by 'a', 'c' or 'y' (default: c):
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3847 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3848 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3849 .IPs a
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
3850 Automatically switch the subfilter off if the CPU is too slow.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3851 .IPs c
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3852 Do chrominance filtering, too.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3853 .IPs y
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3854 Do luminance filtering only (no chrominance).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3855 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3856 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3857 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3858 .RS
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3859 .br
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3860 .I NOTE:
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3861 \-pphelp shows a list of available subfilters.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
3862 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3863 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3864 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3865 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3866 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3867 .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
3868 horizontal and vertical deblocking, deringing and automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3869 brightness/\:contrast
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3870 .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
3871 horizontal and vertical deblocking, deringing, automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3872 brightness/\:contrast and linear blend deinterlacer
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3873 .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
3874 default filters without brightness/\:contrast correction
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3875 .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
3876 Enable default filters & temporal denoiser.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3877 .IPs "\-vf pp=hb:y/vb:a"
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
3878 Horizontal deblocking on luminance only, and switch vertical deblocking
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
3879 on or off automatically depending on available CPU time.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3880 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3881 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3882 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3883 .TP
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3884 .B spp[=quality[:qp[:mode]]]
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3885 simple postprocessing filter
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3886 .RSs
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3887 .IPs quality
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3888 0\-6 (default: 3)
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3889 .IPs qp\ \ \
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
3890 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
3891 .IPs mode\ \ \
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3892 0: hard thresholding (default)
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3893 .br
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3894 1: soft thresholding (better deringing, but blurrier)
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3895 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3896 .
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3897 .TP
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
3898 .B qp=equation
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
3899 quantization parameter (QP) change filter
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3900 .RSs
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
3901 .IPs equation
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3902 some equation like "2+2*sin(PI*qp)"
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3903 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3904 .
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3905 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3906 .B test\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3907 Generate various test patterns.
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
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3910 .B rgbtest
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3911 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
3912 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
3913 .
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3914 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3915 .B lavc[=quality:fps]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3916 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
3917 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
3918 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3919 .IPs quality
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3920 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3921 1\-31: fixed qscale
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3922 .br
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3923 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
3924 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3925 .IPs fps\ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3926 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
3927 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3928 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3929 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3930 .B fame\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3931 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
3932 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3933 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3934 .B dvbscale[=aspect]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3935 Set up optimal scaling for DVB cards, scaling the x axis in hardware and
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3936 calculating the y axis scaling in software to keep aspect.
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3937 Only useful together with expand and scale.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3938 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3939 .IPs aspect
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
3940 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
3941 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
3942 .RE
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3943 .sp 1
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3944 .RS
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3945 .I EXAMPLE:
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3946 .RE
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3947 .PD 0
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3948 .RSs
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3949 .IPs "\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc"
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3950 FIXME: Explain what this does.
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3951 .RE
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3952 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3953 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3954 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3955 .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
3956 Adds noise.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3957 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3958 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3959 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3960 luma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3961 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3962 chroma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3963 .IPs u
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3964 uniform noise (gaussian otherwise)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3965 .IPs t
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3966 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
3967 .IPs a
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3968 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
3969 .IPs h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3970 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
3971 .IPs p
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3972 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
3973 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3974 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3975 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3976 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3977 .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
3978 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
3979 images really still (This should enhance compressibility.).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3980 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3981 .RSs
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3982 .IPs luma\
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3983 spatial luma strength (default: 4)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3984 .IPs chroma
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3985 spatial chroma strength (default: 3)
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3986 .IPs time\
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3987 temporal strength (default: 6)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3988 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3989 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3990 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3991 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3992 .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
3993 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
3994 Parameters and usage are the same.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
3995 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3996 .TP
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
3997 .B eq[=brightness:contrast] (OBSOLETE)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3998 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
3999 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
4000 contrast controls in hardware.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4001 Initial values in the range -100 \- 100 may be given on the command line.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4002 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
4003 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
4004 with lower bitrates.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4005 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4006 .TP
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
4007 .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
4008 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
4009 allowing gamma correction in addition to simple brightness
c934dadd77c2 -vf eq only supports brightness and contrast, noticed by Torinthiel.
diego
parents: 11095
diff changeset
4010 and contrast adjustment.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4011 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
4012 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
4013 The parameters are given as floating point values.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4014 Parameters rg, gg, bg are the independent gamma values for the red, green
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4015 and blue components.
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
4016 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
4017 bright image areas, e.g.\& keep them from getting overamplified and just plain
11609
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
4018 white.
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
4019 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
4020 at its full strength.
11424
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
4021 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
4022 weight=1.0.
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4023 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
4024 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
4025 weight.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4026 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4027 .TP
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4028 .B hue[=hue:saturation]
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4029 Defaults are hue=0.0, saturation=1.0.
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4030 Value ranges are -180\-180 for hue, -2\-2 for saturation (negative values result
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
4031 in a negative chroma).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4032 .
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
4033 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4034 .B halfpack[=f]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4035 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
4036 keeping all chroma samples.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4037 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
4038 is poor quality or is not available.
13273
ae21b81533bb spelling
diego
parents: 13270
diff changeset
4039 Can also be used as a primitive luma-only deinterlacer with very low CPU
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4040 usage.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4041 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
4042 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
4043 odd lines.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4044 Any other value for f gives the default (averaging) behavior.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4045 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4046 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
4047 .B ilpack[=mode]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4048 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
4049 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
4050 the chroma channels.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4051 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
4052 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
4053 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
4054 The optional argument selects the sampling mode.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
4055 By default, linear interpolation (mode 1) is used.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
4056 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
4057 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4058 .TP
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4059 .B harddup
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4060 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4061 If harddup is used when encoding, it will force duplicate frames to be
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4062 encoded in the output.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4063 This uses slightly more space, but is necessary for output to MPEG
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4064 files or if you plan to demux and remux the video stream after
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4065 encoding.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4066 Should be placed at or near the end of the filter chain unless you
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4067 have a good reason to do otherwise.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4068 .
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4069 .TP
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4070 .B softskip
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4071 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4072 Softskip moves the frame skipping (dropping) step of encoding from
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4073 before the filter chain to some point during the filter chain.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4074 This allows filters which need to see all frames (inverse telecine,
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4075 temporal denoising, etc.) to function properly.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4076 Should be placed after the filters which need to see all frames and
12559
diego
parents: 12558
diff changeset
4077 before any subsequent filters that are CPU-intensive.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4078 .
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
4079 .TP
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4080 .B decimate[=max:hi:lo:frac]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4081 Drops frames that do not differ greatly from the previous frame in
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4082 order to reduce framerate.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4083 The argument max (if positive) sets the maximum number of consecutive
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4084 frames which can be dropped, or (if negative) the minimum interval
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4085 between dropped frames.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4086 A frame is a candidate for dropping if no 8x8 region differs by more
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4087 than a threshold of hi, and if not more than frac portion (1 meaning
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4088 the whole image) differs by more than a threshold of lo.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4089 Values of hi and lo are for 8x8 pixel blocks and represent actual
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4090 pixel value differences, so a threshold of 64 corresponds to 1 unit of
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4091 difference for each pixel, or the same spread out differently over the
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4092 block.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4093 The main use of this filter is for very-low-bitrate encoding (e.g.\&
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4094 streaming over dialup modem), but it could in theory be used for
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4095 fixing movies that were inverse-telecined incorrectly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4096 .
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
4097 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4098 .B dint[=sense:level]
13389
d74dcf9851e6 Better wording and clarity as suggested by the Wanderer.
diego
parents: 13386
diff changeset
4099 Detects and drops the first from a set of interlaced video frames.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4100 Values can be from 0.0 to 1.0 \- first (default 0.1) is relative difference
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4101 between neighbor pixels, second (default 0.15) is what part of image has to
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4102 be detected as interlaced to drop the frame.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4103 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4104 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4105 .B lavcdeint
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4106 libavcodec deinterlacing filter
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4107 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4108 .TP
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
4109 .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
4110 Donald Graft's adaptive kernel deinterlacer.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4111 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
4112 .PD 0
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4113 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4114 .IPs "thresh (0 \- 255)"
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
4115 Threshold (default 10).
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4116 .IPs "map (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4117 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
4118 .IPs "order (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4119 Swap fields if 1 (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4120 .IPs "sharp (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4121 Enable additional sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4122 .IPs "twoway (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4123 Enable twoway sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4124 .RE
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4125 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4126 .
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
4127 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4128 .B unsharp=l|cWxH:amount[:l|cWxH:amount]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4129 unsharp mask / gaussian blur
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4130 .RSs
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4131 .IPs l\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4132 Apply effect on luma component.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4133 .IPs c\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4134 Apply effect on chroma components.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4135 .IPs <width>x<height>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4136 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
4137 (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
4138 .IPs amount
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4139 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
4140 (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
4141 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4142 <0: blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4143 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4144 >0: sharpen
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4145 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4146 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4147 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4148 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4149 .B swapuv\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4150 Swap U & V plane.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4151 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4152 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4153 .B il=[d|i][s][:[d|i][s]]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4154 (De)interleaves lines.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4155 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
4156 pre-field without deinterlacing them.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4157 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
4158 interlacing.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4159 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
4160 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
4161 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
4162 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
4163 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4164 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4165 .IPs d
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4166 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
4167 .IPs i
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4168 interleave
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4169 .IPs s
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4170 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
4171 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4172 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4173 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4174 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4175 .B fil=[i|d]
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4176 (De)interleaves lines.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4177 This filter is very similar to the il filter but much faster, the main
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4178 disadvantage is that it does not always work.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4179 Especially if combined with other filters it may produce randomly messed
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4180 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
4181 your combination of filters.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4182 .PD 0
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4183 .RSs
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4184 .IPs d
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4185 Deinterleave fields, placing them side by side.
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4186 .IPs i
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4187 Interleave fields again (reversing the effect of fil=d).
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4188 .RE
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
4189 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4190 .
11251
731652167590 -vf fil
michael
parents: 11247
diff changeset
4191 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4192 .B field[=n]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4193 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
4194 to avoid wasting CPU time.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4195 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
4196 field (depending on whether n is even or odd).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4197 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4198 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4199 .B detc[=var1=value2:var2=value2:...]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4200 Attempts to reverse the 'telecine' process to recover a clean,
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4201 non-interlaced stream at film framerate.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4202 This was the first and most primitive inverse telecine filter to be
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4203 added to MPlayer/\:MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4204 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
4205 long as possible.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4206 This makes it suitable for perfectly-telecined material, even in the
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4207 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
4208 of complex post-telecine edits.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4209 Development on this filter is no longer taking place, as ivtc, pullup,
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4210 and filmdint are better for most applications.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4211 The following arguments (see syntax above) may be used to control
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4212 detc's behavior:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4213 .RSs
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4214 .IPs dr\ \ \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4215 Set the frame dropping mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4216 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
4217 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
4218 merges in the past 5 frames.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4219 2 means always maintain exact 5:4 input to output frame ratio.
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4220 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4221 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4222 Use mode 1 or 2 with MEncoder.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4223 .IPs am\ \ \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4224 Analysis mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4225 Available values are 0 (fixed pattern with initial frame number
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4226 specified by fr=#) and 1 (agressive search for telecine pattern).
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4227 Default is 1.
13378
1b2baad8f949 man page review part IX
diego
parents: 13373
diff changeset
4228 .IPs fr\ \ \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4229 Set initial frame number in sequence.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4230 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
4231 interlaced frames.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4232 The default, -1, means 'not in telecine sequence'.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4233 The number specified here is the type for the imaginary previous
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4234 frame before the movie starts.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4235 .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
4236 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
4237 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4238 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4239 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4240 .B ivtc[=1]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4241 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
4242 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
4243 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
4244 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
4245 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
4246 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
4247 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4248 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
4249 As with detc, you must specify the correct output framerate (\-ofps
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4250 23.976) when using MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4251 Further development on ivtc has stopped, as the pullup and filmdint
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4252 filters appear to be much more accurate.
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
13267
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4255 .B pullup[=jl:jr:jt:jb:sb:mp]\
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4256 Third-generation pulldown reversal (inverse telecine) filter,
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4257 capable of handling mixed hard-telecine, 24 fps progressive, and 30
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4258 fps progressive content.
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4259 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
4260 ivtc, by taking advantage of future context in making its decisions.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4261 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
4262 a pattern to follow, but it instead looks forward to the following
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4263 fields in order to identify matches and rebuild progressive frames.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4264 It is still under development, but believed to be quite accurate.
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4265 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
4266 the left, right, top, and bottom of the image, respectively.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4267 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
4268 2 lines.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4269 The default is 8 pixels on each side.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4270 Setting the sb (strict breaks) option to 1 will reduce the chances of
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4271 pullup generating an occasional mismatched frame, but it may also
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4272 cause an excessive number of frames to be dropped during high motion
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
4273 sequences.
13267
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4274 Conversely, setting it to -1 will make pullup match fields more
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4275 easily.
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4276 This may help processing of video where there is slight blurring
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4277 between the fields, but may also cause there to be interlaced frames
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4278 in the output.
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4279 The mp (metric plane) option may be set to 1 or 2 to use a chroma
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4280 plane instead of the luma plane for doing pullup's computations.
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4281 This may improve accuracy on very clean source material, but more
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4282 likely will decrease accuracy, especially if there is chroma noise
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4283 (rainbow effect) or any grayscale video.
13273
ae21b81533bb spelling
diego
parents: 13270
diff changeset
4284 The main purpose of setting mp to a chroma plane is to reduce CPU load
13267
8d4a16cb1e97 pullup docs + new feature for slow cpus :)
rfelker
parents: 13261
diff changeset
4285 and make pullup usable in realtime on slow machines.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
4286 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4287 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
4288 Always follow pullup with the softskip filter when encoding to ensure
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4289 that pullup is able to see each frame.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4290 Failure to do so will lead to incorrect output and will usually crash,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4291 due to design limitations in the codec/\:filter layer.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4292 .
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
4293 .TP
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4294 .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
4295 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
4296 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
4297 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
4298 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
4299 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
4300 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
4301 approximation.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4302 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
4303 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
4304 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
4305 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
4306 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
4307 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
4308 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
4309 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
4310 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
4311 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
4312 .RSs
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4313 .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
4314 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
4315 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
4316 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
4317 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
4318 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
4319 .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
4320 For each ifps input frames the filter will output ofps frames.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4321 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
4322 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
4323 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
4324 .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
4325 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
4326 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
4327 fields.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4328 .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
4329 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
4330 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
4331 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
4332 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
4333 .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
4334 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
4335 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
4336 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
4337 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
4338 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
4339 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
4340 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
4341 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
4342 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
4343 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
4344 much accuracy.
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
4345 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
4346 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
4347 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
4348 .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
4349 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
4350 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
4351 .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
4352 Deinterlace threshold.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4353 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
4354 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
4355 deinterlacing.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4356 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
4357 .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
4358 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
4359 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
4360 .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
4361 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
4362 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
4363 .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
4364 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
4365 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4366 .
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
4367 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4368 .B softpulldown
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4369 This filter works only correct with MEncoder and acts on the MPEG2 flags
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4370 used for soft 3:2 pulldown (soft telecine).
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4371 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
4372 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
4373 .
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
4374 .TP
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4375 .B divtc[=options]
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4376 Inverse telecine for deinterlaced video.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4377 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
4378 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
4379 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
4380 This filter is intended to find and drop those duplicates and restore the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4381 original film framerate.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4382 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
4383 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
4384 The options are:
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4385 .RSs
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4386 .IPs pass=1|2
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4387 Use two-pass mode.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4388 This produces best results.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4389 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
4390 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
4391 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
4392 process.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4393 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
4394 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
4395 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
4396 .IPs file=filename
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
4397 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
4398 .IPs threshold=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4399 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
4400 believe in it (default: 0.5).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4401 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
4402 that are very dark or very still.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4403 .IPs window=numframes
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4404 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
4405 (default: 30).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4406 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
4407 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
4408 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
4409 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
4410 and past.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4411 .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
4412 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
4413 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
4414 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
4415 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
4416 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
4417 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
4418 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
4419 .IPs deghost=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4420 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
4421 mode, default 0).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4422 If nonzero, deghosting mode is used.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4423 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
4424 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
4425 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
4426 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
4427 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
4428 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
4429 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
4430 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
4431 absolute value of the parameter.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4432 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
4433 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4434 .
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
4435 .TP
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4436 .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
4437 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
4438 changes.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4439 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
4440 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
4441 The options are:
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4442 .RSs
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4443 .IPs t
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4444 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
4445 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
4446 .IPs b
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4447 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
4448 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
4449 .IPs p
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4450 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
4451 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
4452 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
4453 .IPs a
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4454 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
4455 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
4456 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
4457 .IPs u
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4458 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
4459 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
4460 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
4461 fields.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4462 .IPs T
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4463 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
4464 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
4465 .IPs B
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4466 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
4467 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
4468 .IPs A
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4469 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
4470 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
4471 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
4472 This is the default mode.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4473 .IPs U
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4474 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
4475 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
4476 .IPs v
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4477 Verbose operation.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4478 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
4479 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
4480 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4481 .
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
4482 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4483 .B telecine[=start]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4484 Apply 3:2 'telecine' process to increase framerate by 20%.
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
4485 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
4486 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
4487 Both fps options are essential!
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4488 (A/\:V sync will break if they are wrong.)
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4489 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
4490 pattern to start (0\-3).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4491 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4492 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4493 .B tinterlace[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4494 Temporal field interlacing \- merge pairs of frames into an interlaced
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4495 frame, halving the framerate.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4496 Even frames are moved into the upper field, odd frames to the lower field.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4497 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
4498 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
4499 .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
4500 .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
4501 .IPs 0
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4502 Move odd frames into the upper field, even into the lower field, generating
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4503 a full-height frame at half framerate.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4504 .IPs 1
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4505 Only output odd frames, even frames are dropped; height unchanged.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4506 .IPs 2
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4507 Only output even frames, odd frames are dropped; height unchanged.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4508 .IPs 3
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4509 Expand each frame to full height, but pad alternate lines with black;
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4510 framerate unchanged.
10571
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
4511 .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
4512 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4513 .
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
4514 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4515 .B tfields[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4516 Temporal field separation \- split fields into frames, doubling the
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4517 output framerate.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4518 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
4519 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
4520 desired (double) framerate!
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4521 Available modes are:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4522 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4523 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4524 .IPs 0
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4525 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
4526 .IPs 1
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4527 Interpolate missing lines. (The algorithm used might not be so good.)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4528 .IPs 2
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4529 Translate fields by 1/4 pixel with linear interpolation (no jump).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4530 .IPs 4
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4531 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
4532 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4533 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4534 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4535 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4536 .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
4537 box blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4538 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4539 .RSs
13513
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4540 .IPs <radius>
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4541 blur filter strength
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4542 .IPs <power>
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4543 number of filter applications
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4544 .RE
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4545 .PD 1
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4546 .
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4547 .TP
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4548 .B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4549 shape adaptive blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4550 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4551 .RSs
13513
5e9d296e9692 consistency between the blur filter descriptions
diego
parents: 13510
diff changeset
4552 .IPs <radius>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4553 blur filter strength (~0.1\-4.0) (slower if larger)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4554 .IPs <pf>\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4555 prefilter strength (~0.1\-2.0)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4556 .IPs <colorDiff>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4557 maximum difference between pixels to still be considered (~0.1\-100.0)
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4558 .RE
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4559 .PD 1
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4560 .
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4561 .TP
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4562 .B smartblur=radius:strength:threshold[:radius:strength:threshold]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4563 smart blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4564 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4565 .RSs
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4566 .IPs <radius>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4567 blur filter strength (~0.1\-5.0) (slower if larger)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4568 .IPs <strength>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4569 blur (0.0\-1.0) or sharpen (-1.0\-0.0)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4570 .IPs <threshold>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4571 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
4572 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4573 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4574 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4575 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4576 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4577 Correct the perspective of movies not filmed perpendicular to the screen.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4578 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4579 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4580 .IPs x0,y0,...
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4581 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
4582 .IPs t\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4583 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
4584 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4585 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4586 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4587 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4588 .B 2xsai\ \
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4589 Scale and smooth the image with the 2x scale and interpolate algorithm.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4590 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4591 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4592 .B 1bpp\ \ \
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4593 1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4594 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4595 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4596 .B down3dright[=lines]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4597 Reposition and resize stereoscopic images.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4598 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
4599 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
4600 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4601 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4602 .IPs lines
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4603 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
4604 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4605 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4606 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4607 .TP
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4608 .B bmovl=hidden:opaque:fifo
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4609 The bitmap overlay filter reads bitmaps from a FIFO and displays them
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4610 on top of the movie, allowing some transformations on the image.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4611 Also see TOOLS/bmovl-test.c for a small bmovl test program.
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4612 .PD 0
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4613 .RSs
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4614 .IPs <hidden>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4615 Set the default value of the 'hidden' flag (0=visible, 1=hidden).
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4616 .IPs <opaque>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4617 Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4618 .IPs <fifo>
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4619 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
4620 controlling application)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4621 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4622 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4623 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4624 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4625 FIFO commands are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4626 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4627 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4628 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4629 .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
4630 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
4631 .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
4632 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
4633 .IPs "RGB24 width height xpos ypos alpha clear"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4634 followed by width*height*3 Bytes of raw RGB24 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4635 .IPs "BGR24 width height xpos ypos alpha clear"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4636 followed by width*height*3 Bytes of raw BGR24 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4637 .IPs "ALPHA width height xpos ypos alpha"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4638 Change alpha transparency of the specified area.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4639 .IPs "CLEAR width height xpos ypos"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4640 Clear area.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4641 .IPs OPAQUE
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4642 Disable all alpha transparency.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4643 Send "ALPHA 0 0 0 0 0" to enable it again.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4644 .IPs HIDE\
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4645 Hide bitmap.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4646 .IPs SHOW\
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4647 Show bitmap.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4648 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4649 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4650 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4651 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4652 Arguments are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4653 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4654 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4655 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4656 .IPs "width, height"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4657 image/area size
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4658 .IPs "xpos, ypos"
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4659 Start blitting at position x/y.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4660 .IPs alpha
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4661 Set alpha difference.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4662 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
4663 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
4664 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4665 0: same as original
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4666 .br
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4667 255: Make everything opaque.
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4668 .br
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4669 -255: Make everything transparent.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4670 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4671 .IPs clear
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4672 Clear the framebuffer before blitting.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4673 .RSss
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4674 0: The image will just be blitted on top of the old one, so you do not need to
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4675 send 1.8MB of RGBA32 data every time a small part of the screen is updated.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4676 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4677 1: clear
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4678 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4679 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4680 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4681 .
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4682 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4683 .B framestep=I|[i]step
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4684 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
4685 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4686 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
4687 keyframes are rendered.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4688 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
4689 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
4690 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
4691 .sp 1
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
4692 When a keyframe is found, an 'I!' string followed by a newline character is
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
4693 printed, leaving the current line of MPlayer/\:MEncoder output on the screen,
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4694 because it contains the time (in seconds) and frame number of the keyframe
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4695 (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
4696 .sp 1
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4697 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
4698 every 'step' frames is rendered.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4699 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4700 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
4701 (like the I parameter).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4702 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4703 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
4704 printed.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4705 .
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4706 .TP
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4707 .B tile=xtiles:ytiles:output:start:delta
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4708 Tile a series of images into a single, bigger image.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4709 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
4710 value is used.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4711 You can also stop when you are satisfied (... \-vf tile=10:5 ...).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4712 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
4713 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4714 The parameters are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4715 .sp 1
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4716 .PD 0
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4717 .RSs
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4718 .IPs <xtiles>
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4719 number of tiles on the x axis (default: 5)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4720 .IPs <ytiles>
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4721 number of tiles on the y axis (default: 5)
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4722 .IPs <output>
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4723 Render the tile when 'output' number of frames are reached, where 'output'
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4724 should be a number less than xtile * ytile.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4725 Missing tiles are left blank.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4726 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
4727 image every 2 seconds @ 25 fps.
13479
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4728 .IPs <start>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4729 outer border thickness in pixels (default: 2)
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4730 .IPs <delta>
734d74563e5b man page review part X
diego
parents: 13476
diff changeset
4731 inner border thickness in pixels (default: 4)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4732 .RE
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4733 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4734 .
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4735 .TP
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4736 .B delogo[=x:y:w:h:t]
10813
f646e30ba119 spelling/wording fixes
diego
parents: 10812
diff changeset
4737 Suppresses a TV station logo by a simple interpolation of the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4738 surrounding pixels.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4739 Just set a rectangle covering the logo and watch it disappear (and
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4740 sometimes something even uglier appear \- your mileage may vary).
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4741 .PD 0
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4742 .RSs
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4743 .IPs x,y
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4744 top left corner of the logo
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4745 .IPs w,h
13505
06eeeea50186 Better wording/descriptions as suggested by the Wanderer.
diego
parents: 13496
diff changeset
4746 width and height of the cleared rectangle
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4747 .IPs t
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4748 Thickness of the fuzzy edge of the rectangle (added to w and h).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4749 When set to -1, a green rectangle is drawn on the screen to
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4750 simplify finding the right x,y,w,h parameters.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4751 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4752 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4753 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4754 .TP
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4755 .B zrmjpeg[=options]
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4756 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
4757 output device.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4758 .RSs
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4759 .IPs maxheight=h|maxwidth=w
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4760 These options set the maximum width and height the zr card
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4761 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
4762 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4763 Use these options to set maxwidth and maxheight automatically to the
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
4764 values known for card/\:mode combo.
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4765 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
4766 .IPs color|bw
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4767 Select color or black and white encoding.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4768 Black and white encoding is faster.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4769 Color is the default.
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4770 .IPs hdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4771 Horizontal decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4772 .IPs vdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4773 Vertical decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4774 .IPs quality=1-20
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4775 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
4776 .IPs fd|nofd
12028
91eb4f10a9ad spelling fixes
diego
parents: 12016
diff changeset
4777 By default, decimation is only performed if the Zoran hardware
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4778 can upscale the resulting MJPEG images to the original size.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4779 The option fd instructs the filter to always perform the requested
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4780 decimation (ugly).
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4781 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4782 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4783 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4784 .
10380
8627ec205af8 moved -af options to the 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 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4786 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4787 .TP
11454
gabucino
parents: 11448
diff changeset
4788 .B \-audio-delay <0.0\-...>
gabucino
parents: 11448
diff changeset
4789 Sets the audio delay field in the header.
gabucino
parents: 11448
diff changeset
4790 Default is 0.0, negative values do not work.
gabucino
parents: 11448
diff changeset
4791 This does not delay the audio while encoding, but the player will see the
gabucino
parents: 11448
diff changeset
4792 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
4793 .
11454
gabucino
parents: 11448
diff changeset
4794 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4795 .B \-audio-density <1\-50>
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4796 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
4797 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4798 .I NOTE:
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4799 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
4800 .
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4801 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4802 .B \-audio-preload <0.0\-2.0>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4803 Sets up the audio buffering time interval (default: 0.5s).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4804 .
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4805 .TP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4806 .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
4807 Stop encoding at the given time or byte position.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4808 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4809 .I NOTE:
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4810 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
4811 a frame boundary.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4812 .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
4813 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4814 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4815 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4816 .IPs "\-endpos 56"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4817 Encode only 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4818 .IPs "\-endpos 01:10:00"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4819 Encode only 1 hour 10 minutes.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4820 .IPs "\-endpos 100mb"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4821 Encode only 100 MBytes.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4822 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4823 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4824 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4825 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4826 .B \-ffourcc <fourcc>
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4827 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
4828 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4829 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4830 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4831 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4832 .IPs "\-ffourcc div3"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4833 Will have the output file contain 'div3' as video fourcc.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4834 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4835 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4836 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4837 .TP
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4838 .B \-force-avi-aspect <0.2\-3.0>
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4839 Override the aspect stored in the AVI OpenDML vprp header.
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4840 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
4841 .
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4842 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4843 .B \-info <option1:option2:...> (AVI only)
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4844 Specify the info header of the resulting AVI file.
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4845 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4846 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
4847 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4848 .IPs help\
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4849 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
4850 .IPs name=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4851 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
4852 .IPs artist=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4853 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
4854 .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
4855 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
4856 .IPs subject=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4857 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
4858 .IPs copyright=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4859 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
4860 .IPs srcform=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4861 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
4862 .IPs comment=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4863 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
4864 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4865 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4866 .TP
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4867 .B \-noautoexpand
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4868 Do not automatically insert the expand filter into the MEncoder filter chain.
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4869 Useful to control at which point of the filter chain subtitles are rendered
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4870 when hardcoding subtitles onto a movie.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4871 .
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4872 .TP
13270
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4873 .B \-noencodedups
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4874 Do not attempt to encode duplicate frames in duplicate; always output
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4875 zero-byte frames to indicate duplicates.
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4876 Zero-byte frames will be written anyway unless a filter or encoder
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4877 capable of doing duplicate encoding is loaded.
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4878 Currently the only such filter is harddup.
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4879 .
a949c98e02fd finally diego will be happy....this is totally useless but oh well :)
rfelker
parents: 13269
diff changeset
4880 .TP
12366
b6ff3941519b standard notation
diego
parents: 12363
diff changeset
4881 .B \-noodml (\-of avi only)
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
4882 Do not write OpenDML index for AVI files >1GB.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4883 .
12363
5dac21977312 Allow user to disable writing of ODML index
ranma
parents: 12339
diff changeset
4884 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4885 .B \-noskip
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4886 Do not skip frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4887 .
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4888 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4889 .B \-o <filename>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4890 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
4891 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4892 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4893 .B \-oac <codec name>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4894 Encode with the given audio codec (no default set).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4895 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4896 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4897 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
4898 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4899 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4900 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4901 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4902 .IPs "\-oac copy"
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4903 no encoding, just streamcopy
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4904 .IPs "\-oac pcm"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4905 Encode to uncompressed PCM.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4906 .IPs "\-oac mp3lame"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4907 Encode to MP3 (using LAME).
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4908 .IPs "\-oac lavc"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4909 Encode with a libavcodec codec.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4910 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4911 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4912 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4913 .TP
8685
a90839057e15 -of is beta code
jonas
parents: 8682
diff changeset
4914 .B \-of <format> (BETA CODE!)
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4915 Encode to the specified container format (default: AVI).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4916 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4917 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4918 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
4919 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4920 .I EXAMPLE:
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4921 .PD 0
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4922 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4923 .IPs "\-of avi"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4924 Encode to AVI.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4925 .IPs "\-of mpeg"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4926 Encode to MPEG.
12016
b962aaad2940 rawvideo muxer patch by John Earl <jwe21@cam.ac.uk>
ranma
parents: 12013
diff changeset
4927 .IPs "\-of rawvideo"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4928 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
4929 .RE
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4930 .PD 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4931 .
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4932 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4933 .B \-ofps <fps>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4934 Specify a frames per second (fps) value for the output file,
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4935 which can be different from that of the source material.
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4936 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
4937 (29.97fps telecined MPEG) files.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4938 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4939 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4940 .B \-ovc <codec name>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4941 Encode with the given video codec (no default set).
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4942 .br
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4943 .I NOTE:
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4944 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
4945 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4946 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4947 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4948 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4949 .IPs "\-ovc copy"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4950 no encoding, just streamcopy
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4951 .IPs "\-ovc divx4"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4952 Encode to DivX4/\:DivX5.
11966
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
4953 .IPs "\-ovc raw"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4954 Encode to an arbitrary uncompressed format (use \-vf format to select).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4955 .IPs "\-ovc lavc"
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4956 Encode with a libavcodec codec.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4957 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4958 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4959 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4960 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4961 .B \-passlogfile <filename>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4962 Dump first pass information to <filename> instead of the default divx2pass.log
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4963 in 2-pass encoding mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4964 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4965 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4966 .B \-skiplimit <value>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4967 Specify the maximum number of frames that may be skipped after
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4968 encoding one frame (\-noskiplimit for unlimited).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4969 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4970 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4971 .B \-vobsubout <basename>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4972 Specify the basename for the output .idx and .sub files.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4973 This turns off subtitle rendering in the encoded movie and diverts it to
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
4974 VOBsub subtitle files.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
4975 .
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4976 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4977 .B \-vobsuboutid <langid>
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4978 Specify the language two letter code for the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4979 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
4980 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4981 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4982 .B \-vobsuboutindex <index>
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
4983 Specify the index of the subtitles in the output files (default: 0).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4984 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4985 .
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 .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
4988 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
4989 syntax:
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 \-<codec>opts <option1[=value],option2,...>
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
4993 .
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4994 .PP
13638
f453d6526a06 Added missing toolame to the list of codec specific encoding options.
diego
parents: 13636
diff changeset
4995 Where <codec> may be: lavc, xvidenc, divx4, lame, toolame, x264enc
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4996 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4997 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4998 .SS divx4 (\-divx4opts)
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
4999 DivX4 is obsolete and only supported for completeness.
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
5000 For details about DivX4 options, read the source, most options are not
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
5001 described here.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5002 .
10380
8627ec205af8 moved -af options to the 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 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5004 .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
5005 get help
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5006 .
10380
8627ec205af8 moved -af options to the 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 .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
5008 .B br=<value>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5009 Specify bitrate.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5010 .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
5011 .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
5012 (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
5013 .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
5014 (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
5015 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5016 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5017 .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
5018 .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
5019 maximum keyframe interval (in frames)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5020 .
10380
8627ec205af8 moved -af options to the 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 .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
5022 .B deinterlace
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5023 Enable deinterlacing (avoid it, DivX4 is buggy).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5024 .
10380
8627ec205af8 moved -af options to the 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 .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
5026 .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
5027 quality (1\-fastest, 5\-best)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5028 .
10380
8627ec205af8 moved -af options to the 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 .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
5030 .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
5031 minimum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5032 .
10380
8627ec205af8 moved -af options to the 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 .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
5034 .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
5035 maximum quantizer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5036 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5037 .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
5038 .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
5039 rate control period
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5040 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5041 .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
5042 .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
5043 rate control reaction period
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5044 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5045 .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
5046 .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
5047 rate control reaction ratio
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5048 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5049 .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
5050 .B crispness=<0\-100>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5051 Specify crispness/\:smoothness.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5052 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5053 .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
5054 .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
5055 With this you can encode 2pass DivX4 files.
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5056 First encode with pass=1, then do another encode with the
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5057 same parameters and pass=2.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5058 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5059 .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
5060 .B vbrpass=<0\-2>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5061 Override the pass argument and use the XviD VBR library instead of DivX4 VBR.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5062 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
5063 .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
5064 .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
5065 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
5066 .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
5067 Analysis (first) pass of two pass encoding.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5068 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
5069 .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
5070 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
5071 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5072 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5073 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5074 .SS lame (\-lameopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5075 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5076 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5077 .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
5078 get help
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5079 .
10380
8627ec205af8 moved -af options to the 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 .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
5081 .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
5082 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
5083 .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
5084 .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
5085 .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
5086 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
5087 .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
5088 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
5089 .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
5090 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
5091 .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
5092 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
5093 .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
5094 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
5095 .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
5096 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5097 .
10380
8627ec205af8 moved -af options to the 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 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5099 .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
5100 average bitrate
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5101 .
10380
8627ec205af8 moved -af options to the 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 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5103 .B cbr\ \ \ \
13648
0dd7df7510a5 missing sentence dots
wight
parents: 13642
diff changeset
5104 constant bitrate
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5105 Also forces CBR mode encoding on subsequent ABR presets modes.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5106 .
10380
8627ec205af8 moved -af options to the 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 .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
5108 .B br=<0\-1024>
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5109 bitrate in kbps (CBR and ABR only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5110 .
10380
8627ec205af8 moved -af options to the 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 .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
5112 .B q=<0\-9>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5113 quality (0\-highest, 9\-lowest) (VBR only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5114 .
10380
8627ec205af8 moved -af options to the 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 .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
5116 .B aq=<0\-9>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5117 algorithmic quality (0\-best/\:slowest, 9\-worst/\:fastest)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5118 .
10380
8627ec205af8 moved -af options to the 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 .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
5120 .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
5121 compression ratio
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5122 .
10380
8627ec205af8 moved -af options to the 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 .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
5124 .B vol=<0\-10>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5125 audio input gain
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5126 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5127 .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
5128 .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
5129 (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
5130 .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
5131 .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
5132 .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
5133 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
5134 .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
5135 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
5136 .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
5137 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
5138 .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
5139 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
5140 .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
5141 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5142 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5143 .TP
8627ec205af8 moved -af options to the 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 .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
5145 .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
5146 .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
5147 .IPs 0
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5148 none
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5149 .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
5150 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
5151 .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
5152 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
5153 .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
5154 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5155 .
10380
8627ec205af8 moved -af options to the 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 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5157 .B fast\ \ \
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5158 Switch on faster encoding on subsequent VBR presets modes.
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5159 This results in slightly lower quality and higher bitrates.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5160 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5161 .TP
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5162 .B highpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5163 Set a highpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5164 Frequencies below the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
5165 A value of -1 will disable filtering, a value of 0
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5166 will let LAME choose values automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5167 .
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5168 .TP
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5169 .B lowpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5170 Set a lowpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5171 Frequencies above the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
5172 A value of -1 will disable filtering, a value of 0
13214
4a4262f8d7d0 man page review part VII
diego
parents: 13211
diff changeset
5173 will let LAME choose values automatically.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5174 .
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
5175 .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
5176 .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
5177 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
5178 .RSs
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5179 .IPs help\
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5180 Print additional options and information about presets settings.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5181 .IPs medium
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5182 VBR encoding, good quality, 150\-180 kbps bitrate range
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5183 .IPs standard
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5184 VBR encoding, high quality, 170\-210 kbps bitrate range
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5185 .IPs extreme
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5186 VBR encoding, very high quality, 200\-240 kbps bitrate range
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5187 .IPs insane
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5188 CBR encoding, highest preset quality, 320 kbps bitrate
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5189 .IPs <8\-320>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5190 ABR encoding at average given kbps bitrate
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5191 .RE
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5192 .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
5193 .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
5194 .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
5195 .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
5196 .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
5197 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5198 .IPs fast:preset=standard
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5199 suitable for most people and most music types and already quite high quality
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5200 .IPs cbr:preset=192
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5201 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
5202 .IPs preset=172
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5203 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
5204 .IPs preset=extreme
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
5205 for people with extremely good hearing and similar equipment
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5206 .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
5207 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5208 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5209 .
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5210 .SS toolame (\-toolameopts)
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5211 .
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5212 .TP
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5213 .B br=<0\-384> (CBR only)
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
5214 bitrate in kbps
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5215 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5216 .B mode=<stereo | jstereo | mono | dual>
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5217 (default: mono for 1-channel audio, stereo otherwise)
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5218 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5219 .B psy=<0\-3>
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5220 psychoacoustic model (default: 2)
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5221 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5222 .B errprot=<0 | 1>
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5223 Include error protection.
13426
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5224 .TP
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5225 .B debug=<0\-10>
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5226 debug level
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5227 .RE
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5228 .PD 1
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5229 .
0f92ad66bbb5 encoding to mp2 with libtoolame
nicodvb
parents: 13417
diff changeset
5230 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5231 .SS lavc (\-lavcopts)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5232 Many libavcodec (lavc for short) options are tersely documented.
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5233 Read the source for full details.
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5234 .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
5235 .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
5236 .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
5237 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5238 .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
5239 .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
5240 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5241 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5242 .TP
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5243 .B acodec=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5244 audio codec (default: mp2)
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5245 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5246 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5247 .IPs mp2\ \
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5248 MPEG Layer 2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5249 .IPs mp3\ \
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5250 MPEG Layer 3
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5251 .IPs ac3\ \
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5252 AC3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5253 .IPs adpcm_ima_wav
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5254 IMA Adaptive PCM (4bits per sample, 4:1 compression)
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5255 .RE
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5256 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5257 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5258 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5259 .B abitrate=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5260 audio bitrate in kbps (default: 224)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5261 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5262 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5263 .B atag=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5264 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
5265 .
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
5266 .TP
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
5267 .B bit_exact
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5268 Use only bit exact algorithms (except (I)DCT).
11938
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5269 Additionally bit_exact disables several optimizations and thus
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5270 should only be used for regression tests, which need binary
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5271 identical files even if the encoder version changes.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5272 This also suppresses the user_data header in MPEG-4 streams.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
5273 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
5274 .
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
5275 .TP
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5276 .B threads=<1\-8>
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5277 Maximum number of threads to use (default: 1).
13208
a4601e903824 The threads lavc option may negatively affect motion estimation.
diego
parents: 13205
diff changeset
5278 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
5279 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5280 .
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
5281 .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
5282 .B vcodec=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5283 Employ the specified codec (default: mpeg4).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5284 .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
5285 .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
5286 .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
5287 Motion JPEG
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5288 .IPs ljpeg
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5289 Lossless JPEG
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5290 .IPs h263\
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5291 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
5292 .IPs h263p
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5293 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
5294 .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
5295 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
5296 .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
5297 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
5298 .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
5299 MS MPEG4v2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5300 .IPs wmv1\
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
5301 Windows Media Video, version 1 (AKA WMV7)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5302 .IPs wmv2\
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
5303 Windows Media Video, version 2 (AKA WMV8)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5304 .IPs rv10\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5305 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
5306 .IPs mpeg1video
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5307 MPEG1 video
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5308 .IPs mpeg2video
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5309 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
5310 .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
5311 HuffYUV
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5312 .IPs asv1\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5313 ASUS Video v1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5314 .IPs asv2\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5315 ASUS Video v2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5316 .IPs ffv1\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5317 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
5318 .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
5319 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5320 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5321 .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
5322 .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
5323 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
5324 .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
5325 .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
5326 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
5327 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
5328 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
5329 .IPs 2
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5330 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
5331 .IPs 3
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5332 Recommended for h263(p)/\:msmpeg4.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5333 The reason for preferring 3 over 2 is that 2 could lead to overflows.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5334 (This will be fixed for h263(p) by changing the quantizer per MB in
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5335 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
5336 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5337 .
10380
8627ec205af8 moved -af options to the 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 .TP
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5339 .B lmin=<0.01\-255.0>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5340 Minimum Lagrange multiplier for ratecontrol, you probably want it to be
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5341 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
5342 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5343 .
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5344 .TP
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5345 .B lmax=<0.01\-255.0>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5346 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
5347 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5348 .
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
5349 .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
5350 .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
5351 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
5352 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
5353 1 is not recommended (see vqmin for details).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5354 .
10380
8627ec205af8 moved -af options to the 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 .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
5356 .B vqmax=<1\-31>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5357 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
5358 .
10380
8627ec205af8 moved -af options to the 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 .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
5360 .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
5361 minimum macroblock quantizer (pass\ 1/\:2) (default: 2)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5362 .
10380
8627ec205af8 moved -af options to the 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 .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
5364 .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
5365 maximum macroblock quantizer (pass\ 1/\:2) (default: 31)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5366 .
10380
8627ec205af8 moved -af options to the 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 .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
5368 .B vqdiff=<1\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5369 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
5370 .
10380
8627ec205af8 moved -af options to the 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 .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
5372 .B vmax_b_frames=<0\-4>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5373 maximum number of B-frames between non-B-frames:
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5374 .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
5375 .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
5376 .IPs 0
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5377 no B-frames (default)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5378 .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
5379 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
5380 .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
5381 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5382 .
10380
8627ec205af8 moved -af options to the 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 .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
5384 .B vme=<0\-5>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5385 motion estimation method.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5386 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
5387 .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
5388 .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
5389 .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
5390 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
5391 .IPs 1
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5392 full (slow, currently unmaintained and disabled)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5393 .IPs 2
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5394 log (low quality, currently unmaintained and disabled)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5395 .IPs 3
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5396 phods (low quality, currently unmaintained and disabled)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5397 .IPs 4
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5398 EPZS: size=1 diamond, size can be adjusted with the *dia options
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5399 (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
5400 .IPs 5
13463
1b0641cf7fd2 Better vme description
gpoirier
parents: 13456
diff changeset
5401 X1 (experimental, currently aliased to EPZS)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5402 .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
5403 .PD 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5404 .sp 1
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5405 .RS
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5406 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5407 .I NOTE:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5408 0\-3 currently ignores the amount of bits spent,
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5409 so quality may be low.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5410 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5411 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5412 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5413 .B me_range=<0\-9999>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5414 motion estimation search range (default: 0 (unlimited))
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5415 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5416 .TP
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5417 .B mbd=<0\-2>
10503
diego
parents: 10498
diff changeset
5418 Macroblock decision algorithm (high quality mode), encode each macro
diego
parents: 10498
diff changeset
5419 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
5420 This is slow but results in better quality and file size.
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5421 .PD 0
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5422 .RSs
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5423 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5424 Use mbcmp (default).
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5425 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5426 Select the MB mode which needs the fewest bits (=vhq).
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5427 .IPs 2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5428 Select the MB mode which has the best rate distortion.
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5429 .RE
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
5430 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5431 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5432 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5433 .B vhq\ \ \ \
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5434 Same as mbd=1, kept for compatibility reasons.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5435 .
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5436 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5437 .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
5438 Allow 4 motion vectors per macroblock (slightly better quality).
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5439 Works better if used with mbd>0.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5440 .
10380
8627ec205af8 moved -af options to the 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 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5442 .B obmc\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5443 overlapped block motion compensation (H.263+)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5444 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5445 .TP
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5446 .B loop\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5447 loop filter (H.263+)
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5448 note, this is broken
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5449 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5450 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5451 .B inter_threshold <-1000\-1000>
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5452 Does absolutely nothing at the moment.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5453 .
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5454 .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
5455 .B keyint=<0\-300>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5456 maximum interval between keyframes in frames (default: 250 or one
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5457 keyframe every ten seconds in a 25fps movie).
10380
8627ec205af8 moved -af options to the 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 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
5459 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
5460 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
5461 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
5462 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
5463 For a strict MPEG1/\:2/\:4 compliance this would have to be <=132.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5464 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5465 .TP
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5466 .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
5467 Threshold for scene change detection.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5468 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
5469 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
5470 -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
5471 no scene changes are detected (default 0).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5472 .
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
5473 .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
5474 .B vb_strategy=<0\-1>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5475 strategy to choose between I/\:P/\:B-frames (pass\ 2):
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5476 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5477 .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
5478 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5479 Always use the maximum number of B-frames (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5480 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5481 Avoid B-frames in high motion scenes.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5482 This will cause bitrate misprediction.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5483 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5484 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5485 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5486 .TP
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5487 .B vpass=<1\-3>
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5488 Activates internal two (or three) pass mode, only specify if you wish to
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5489 use two (or three) pass encoding.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5490 .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
5491 .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
5492 .IPs 1
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5493 first pass (also see turbo)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5494 .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
5495 second pass
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5496 .IPs 3
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5497 Nth pass (second and third passes of three pass encoding)
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5498 .RE
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5499 .RS
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5500 Here is how it works, and how to use it:
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5501 .br
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5502 The first pass (vpass=1) writes the stats file.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5503 You might want to deactivate some CPU-hungry options, like "turbo"
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5504 mode does.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5505 .br
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5506 In two pass mode, the second pass (vpass=2) reads the stats file and
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
5507 bases ratecontrol decisions on it.
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5508 .br
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5509 In three pass mode, the second pass (vpass=3, that is not a typo )
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5510 does both: It first reads the stats, then overwrites them.
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5511 You might want to backup divx2pass.log before doing this if there is
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5512 any possibility that you will have to cancel MEncoder.
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5513 You can use all encoding options, except very CPU-hungry options like "qns".
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5514 .br
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5515 The third pass (vpass=3) is the same as the second pass, except that it has
13407
88f66c6b9637 Reworked description of lavc's 3-pass encoding; patch by its creator
gpoirier
parents: 13405
diff changeset
5516 the second pass's stats to work from.
13416
f26b6434ce9f Fixes suggested by Diego
gpoirier
parents: 13412
diff changeset
5517 You can use all encoding options, including CPU-hungry ones.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5518 .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
5519 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5520 .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
5521 .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
5522 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
5523 .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
5524 .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
5525 .RSs
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
5526 .IPs "pass 1"
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
5527 Saves statistics.
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
5528 .IPs "pass 2"
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5529 Encodes with an optimal Huffman table based upon statistics
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5530 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
5531 .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
5532 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5533 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5534 .TP
13386
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5535 .B turbo (2-pass only)
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5536 Dramatically speeds up pass 1 using faster algorithms and disabling
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5537 CPU-intensive options.
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5538 This will probably reduce global PSNR a little bit (around 0.01dB) and
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5539 change individual frame type and PSNR little bit more (up to 0.03dB).
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5540 .
d8ba5b72fc6c New lavc flag: "turbo" mode which is supposed to speed up 2-pass encoding
gpoirier
parents: 13378
diff changeset
5541 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5542 .B aspect=<x/\:y>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5543 Store movie aspect internally, just like with MPEG files.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5544 Much nicer than rescaling, because quality is not decreased.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5545 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
5546 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
5547 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
5548 .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
5549 .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
5550 .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
5551 .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
5552 .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
5553 .PD 0
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5554 .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
5555 .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
5556 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5557 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5558 .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
5559 .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
5560 Same as the aspect option, but automatically computes aspect, taking
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5561 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
5562 filter chain.
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5563 Does not incur a performance penalty, so you can safely leave it
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5564 always on.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5565 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5566 .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
5567 .B vbitrate=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5568 Specify bitrate (pass\ 1/\:2) (default: 800).
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5569 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5570 .I WARNING:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5571 1kBit = 1000 Bits
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5572 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5573 .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
5574 .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
5575 (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
5576 .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
5577 (in bit)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5578 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5579 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5580 .
10380
8627ec205af8 moved -af options to the 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 .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
5582 .B vratetol=<value>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5583 approximated filesize tolerance in kBit.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5584 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
5585 (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
5586 (default: 8000)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5587 .br
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5588 .I NOTE:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5589 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
5590 be problems if vrc_(min|max)rate is used.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5591 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5592 .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
5593 .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
5594 maximum bitrate in kbit/\:sec (pass\ 1/\:2)
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
5595 (default: 0, unlimited)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5596 .
10380
8627ec205af8 moved -af options to the 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 .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
5598 .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
5599 minimum bitrate in kbit/\:sec (pass\ 1/\:2)
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
5600 (default: 0, unlimited)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5601 .
10380
8627ec205af8 moved -af options to the 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 .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
5603 .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
5604 buffer size in kbit (pass\ 1/\:2).
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5605 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
5606 917 for SVCD and 1835 for DVD.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5607 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5608 .TP
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5609 .B vrc_buf_aggressivity
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5610 currently useless
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5611 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5612 .TP
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5613 .B vrc_strategy
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5614 Dummy, reserved for future use.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5615 .
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5616 .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
5617 .B vb_qfactor=<-31.0\-31.0>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5618 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
5619 .
10380
8627ec205af8 moved -af options to the 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 .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
5621 .B vi_qfactor=<-31.0\-31.0>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5622 quantizer factor between I- and non-I-frames (pass\ 1/\:2) (default: 0.8)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5623 .
10380
8627ec205af8 moved -af options to the 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 .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
5625 .B vb_qoffset=<-31.0\-31.0>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5626 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
5627 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5628 .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
5629 .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
5630 (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
5631 .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
5632 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
5633 .br
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5634 I/\:B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5635 .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
5636 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
5637 .br
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5638 do normal ratecontrol (do not lock to next P-frame quantizer) and
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5639 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5640 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5641 .I HINT:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5642 To do constant quantizer encoding with different quantizers for
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5643 I/\:P- and B-frames you can use:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5644 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
5645 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5646 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5647 .B vqblur=<0.0\-1.0> (pass 1)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5648 Quantizer blur (default: 0.5), larger values will average the
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5649 quantizer more over time (slower change).
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5650 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5651 .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
5652 .IPs 0.0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5653 Quantizer blur disabled.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5654 .IPs 1.0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5655 Average the quantizer over all previous frames.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5656 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5657 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5658 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5659 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
5660 .B vqblur=<0.0\-99.0> (pass 2)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5661 Quantizer gaussian blur (default: 0.5), larger values will average
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5662 the quantizer more over time (slower change).
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 vqcomp=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5666 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
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 vrc_eq=<equation>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5670 main ratecontrol equation (pass\ 1/\:2)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5671 .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
5672 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5673 .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
5674 constant bitrate
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5675 .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
5676 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
5677 .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
5678 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
5679 .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
5680 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
5681 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5682 .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
5683 .RS
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5684 infix operators:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5685 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5686 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5687 .IPs +,-,*,/,^
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5688 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5689 .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
5690 .RS
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5691 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
5692 .RE
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5693 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5694 .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
5695 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
5696 .IPs iTex,pTex
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5697 intra, non-intra texture complexity
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5698 .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
5699 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
5700 .IPs avgIITex
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5701 average intra texture complexity in I-frames
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5702 .IPs avgPITex
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
5703 average intra texture complexity in P-frames
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5704 .IPs avgPPTex
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5705 average non-intra texture complexity in P-frames
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5706 .IPs avgBPTex
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5707 average non-intra texture complexity in B-frames
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5708 .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
5709 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
5710 .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
5711 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
5712 .IPs iCount
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5713 number of intra macroblocks / number of macroblocks
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5714 .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
5715 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
5716 .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
5717 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
5718 .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
5719 qcomp from the command line
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5720 .IPs "isI, isP, isB"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5721 Is 1 if picture type is I/\:P/\:B else 0.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5722 .IPs Pi,E\
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5723 See your favorite math book.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5724 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5725 .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
5726 .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
5727 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
5728 .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
5729 .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
5730 .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
5731 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
5732 .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
5733 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
5734 .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
5735 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
5736 .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
5737 is 1 if a==b, 0 otherwise
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5738 .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
5739 .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
5740 .
8627ec205af8 moved -af options to the 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 .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
5742 .B vrc_override=<options>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5743 User specified quality for specific parts (ending, credits, ...) (pass\ 1/\:2).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5744 The options are <start-frame>, <end-frame>, <quality>[/\:<start-frame>,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5745 <end-frame>, <quality>[/\:...]]:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5746 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5747 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5748 .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
5749 quantizer
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5750 .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
5751 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
5752 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5753 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5754 .
10380
8627ec205af8 moved -af options to the 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 .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
5756 .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
5757 initial complexity (pass\ 1)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5758 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5759 .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
5760 .B vqsquish=<0,1>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5761 Specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5762 .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
5763 .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
5764 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5765 Use clipping.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5766 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5767 Use a nice differentiable function (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5768 .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
5769 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5770 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5771 .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
5772 .B vlelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5773 Sets single coefficient elimination threshold for luminance.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5774 Negative values will also consider the DC coefficient (should be at least -4
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5775 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
5776 .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
5777 .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
5778 .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
5779 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
5780 .IPs -4
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5781 JVT recommendation
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5782 .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
5783 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5784 .
10380
8627ec205af8 moved -af options to the 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 .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
5786 .B vcelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5787 Sets single coefficient elimination threshold for chrominance.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5788 Negative values will also consider the DC coefficient (should be at least -4
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5789 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
5790 .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
5791 .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
5792 .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
5793 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
5794 .IPs 7
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5795 JVT recommendation
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5796 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5797 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5798 .
10380
8627ec205af8 moved -af options to the 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 .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
5800 .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
5801 strict standard compliance
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5802 .PD 0
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5803 .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
5804 .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
5805 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
5806 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5807 Only recommended if you want to feed the output into the
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5808 MPEG4 reference decoder.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5809 .IPs -1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5810 Allows non-standard YV12 HuffYUV encoding (20% smaller files, but cannot be
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5811 played by the official HuffYUV codec).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5812 .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
5813 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5814 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5815 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5816 .B vdpart\
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5817 Data partitioning.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5818 Adds 2 Bytes per video packet, improves error-resistance when transferring over
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5819 unreliable channels (e.g.\& streaming over the internet).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5820 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
5821 .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
5822 .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
5823 .IPs "1. MVs"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5824 movement
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5825 .IPs "2. DC coefficients"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5826 low res picture
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5827 .IPs "3. AC coefficients"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5828 details
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5829 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5830 .PD 1
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5831 .RS
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5832 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
5833 the AC and the 1. & 2. partition.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5834 (MV & DC) are far smaller than the 3. partition (AC) meaning that errors
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5835 will hit the AC partition much more often than the MV & DC partitions.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
5836 Thus, the picture will look better with partitioning than without,
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
5837 as without partitioning an error will trash AC/\:DC/\:MV equally.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5838 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5839 .
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5840 .TP
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5841 .B vpsize=<0\-10000> (also see vdpart)
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5842 Video packet size, improves error-resistance.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5843 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5844 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5845 .IPs 0\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5846 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
5847 .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
5848 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
5849 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5850 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5851 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5852 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5853 .B ss\ \ \ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5854 slice structured mode for H.263+
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5855 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5856 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5857 .B gray\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5858 grayscale only encoding (faster)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5859 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5860 .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
5861 .B vfdct=<0\-10>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5862 DCT algorithm
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5863 .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
5864 .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
5865 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5866 Automatically select a good one (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5867 .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
5868 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
5869 .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
5870 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
5871 .IPs 3
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5872 MMX
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5873 .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
5874 mlib
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5875 .IPs 5
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5876 AltiVec
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5877 .IPs 6
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5878 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
5879 .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
5880 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5881 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5882 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5883 .B idct=<0\-99>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5884 IDCT algorithm
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5885 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5886 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5887 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
5888 .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
5889 .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
5890 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5891 Automatically select a good one (default).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5892 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5893 JPEG reference integer
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5894 .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
5895 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
5896 .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
5897 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
5898 .IPs 4
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5899 libmpeg2mmx (inaccurate, do not use for encoding with keyint >100)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5900 .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
5901 ps2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5902 .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
5903 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
5904 .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
5905 arm
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5906 .IPs 8
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5907 AltiVec
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5908 .IPs 9
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5909 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
5910 .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
5911 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5912 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5913 .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
5914 .B lumi_mask=<0.0\-1.0>
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5915 Luminance masking is a 'psychosensory' setting that is supposed to
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
5916 make use of the fact that the human eye tends to notice fewer details
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5917 in very bright parts of the picture.
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5918 Luminance masking compresses bright areas stronger than medium ones,
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5919 so it will save bits that can be spent again on other frames, raising
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5920 overall subjective quality, while possibly reducing PSNR.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5921 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5922 .I WARNING:
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5923 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5924 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5925 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5926 Large values might look good on some monitors but may look horrible
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5927 on other monitors.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5928 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5929 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5930 .IPs 0.0\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5931 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
5932 .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
5933 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
5934 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5935 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5936 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5937 .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
5938 .B dark_mask=<0.0\-1.0>
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5939 Darkness masking is a 'psychosensory' setting that is supposed to
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
5940 make use of the fact that the human eye tends to notice fewer details
13439
b35ec818ebeb small fixes
diego
parents: 13436
diff changeset
5941 in very dark parts of the picture.
13436
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5942 Darkness masking compresses dark areas stronger than medium ones,
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5943 so it will save bits that can be spent again on other frames, raising
0c5197fb6c2d Better lumi/dark_masking descriptions, tips for 4mv and autoaspect and 10l fix
gpoirier
parents: 13435
diff changeset
5944 overall subjective quality, while possibly reducing PSNR.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5945 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5946 .I WARNING:
13058
29d8052f48f7 consistency fix, same sentence should be changed to same
wight
parents: 13053
diff changeset
5947 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5948 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5949 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5950 Large values might look good on some monitors but may look horrible
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5951 on other monitors / TV / TFT.
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5952 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5953 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5954 .IPs 0.0\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5955 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
5956 .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
5957 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
5958 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5959 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
5960 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5961 .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
5962 .B tcplx_mask=<0.0\-1.0>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5963 Temporal complexity masking (default: 0.0 (disabled)).
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
5964 Imagine a scene with a bird flying across the whole scene; tcplx_mask
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
5965 will raise the quantizers of the bird's macroblocks (thus decreasing their
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
5966 quality), as the human eye usually does not have time to see all the bird's
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5967 details.
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5968 Be warned that if the masked object stops (e.g.\& the bird lands) it is
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
5969 likely to look horrible for a short period of time, until the encoder
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
5970 figures out that the object is not moving and needs refined blocks.
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5971 The saved bits will be spent on other parts of the video, which may increase
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5972 subjective quality, provided that tcplx_mask is carefully chosen.
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 scplx_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5976 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
5977 Larger values help against blockiness, if no deblocking filter is used for
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5978 decoding, which is maybe not a good idea.
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5979 .br
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
5980 Imagine a scene with grass (which usually has great spatial complexity),
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
5981 a blue sky and a house; scplx_mask will raise the quantizers of the grass'
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
5982 macroblocks, thus decreasing its quality, in order to spend more bits on
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5983 the sky and the house.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5984 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5985 .I HINT:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5986 Crop any black borders completely as they will reduce the quality
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
5987 of the macroblocks (also applies without scplx_mask).
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5988 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5989 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5990 .IPs 0.0\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5991 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
5992 .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
5993 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
5994 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5995 .PD 1
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5996 .sp 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
5997 .RS
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5998 .I NOTE:
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
5999 This setting does not have the same effect as using a custom matrix that
13492
51c46db54bd2 Sws default setting correction, and random wordings
gpoirier
parents: 13487
diff changeset
6000 would compress high frequencies harder, as scplx_mask will reduce the
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6001 quality of P blocks even if only DC is changing.
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6002 The result of scplx_mask will probably not look as good.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6003 .RE
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6004 .
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6005 .TP
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6006 .B p_mask=<0.0\-1.0> (also see vi_qfactor)
13487
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6007 Reduces the quality of inter blocks.
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6008 This is equivalent to increasing the quality of intra blocks, because the
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6009 same average bitrate will be distributed by the rate controller to the
9483adf5e608 Better phrasing suggested by The Wanderer
gpoirier
parents: 13482
diff changeset
6010 whole video sequence (default: 0.0 (disabled)).
13482
953a15fa07fc better descriptions for remaining, poorly documented masking options.
gpoirier
parents: 13479
diff changeset
6011 p_mask=1.0 doubles the bits allocated to each intra block.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6012 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6013 .TP
11430
nicolas
parents: 11424
diff changeset
6014 .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
6015 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
6016 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
6017 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
6018 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
6019 average.
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
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6022 .B ildct\ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6023 Use interlaced DCT.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6024 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6025 .TP
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6026 .B ilme\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
6027 Use interlaced motion estimation (mutually exclusive with qpel).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6028 .
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6029 .TP
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6030 .B alt\ \ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6031 Use alternative scantable.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6032 .
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
6033 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6034 .B top=<-1\-1>\ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6035 .PD 0
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6036 .RSs
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6037 .IPs -1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6038 automatic
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6039 .IPs 0
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6040 bottom field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6041 .IPs 1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6042 top field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6043 .RE
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6044 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6045 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6046 .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
6047 .B format=<value>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6048 .PD 0
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6049 .RSs
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6050 .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
6051 default
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6052 .IPs 444P\
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6053 for ffv1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6054 .IPs 422P\
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6055 for HuffYUV, lossless JPEG and ffv1
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6056 .IPs 411P,YVU9
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6057 for lossless JPEG and ffv1
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6058 .IPs BGR32
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6059 for lossless JPEG and ffv1
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6060 .RE
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6061 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6062 .
10380
8627ec205af8 moved -af options to the 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 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6064 .B pred\ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6065 (for HuffYUV)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6066 .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
6067 .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
6068 .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
6069 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
6070 .IPs 1
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6071 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
6072 .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
6073 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
6074 .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
6075 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6076 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6077 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6078 .B pred\ \ \
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6079 (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
6080 .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
6081 .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
6082 .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
6083 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
6084 .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
6085 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
6086 .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
6087 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
6088 .IPs 3
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6089 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
6090 .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
6091 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
6092 .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
6093 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6094 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6095 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6096 .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
6097 (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
6098 .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
6099 .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
6100 .IPs 0
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6101 vlc coding (Golomb-Rice)
11059
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6102 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6103 arithmetic coding (CABAC)
11059
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
6104 .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
6105 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6106 .
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
6107 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6108 .B context
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6109 (for ffv1)
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6110 .PD 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6111 .RSs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6112 .IPs 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6113 small context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6114 .IPs 1
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6115 large context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6116 .RE
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6117 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6118 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6119 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6120 .B qpel\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
6121 Use quarter pel motion compensation (mutually exclusive with ilme).
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6122 .br
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6123 .I HINT:
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6124 This seems only useful for high bitrate encodings.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6125 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6126 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6127 .B mbcmp=<0\-2000>
13648
0dd7df7510a5 missing sentence dots
wight
parents: 13642
diff changeset
6128 Sets the comparison function for the macroblock decision, only used if mbd=0.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6129 .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
6130 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6131 .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
6132 sum of absolute differences, fast (default)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6133 .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
6134 sum of squared errors
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6135 .IPs "2 (SATD)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6136 sum of absolute Hadamard transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6137 .IPs "3 (DCT)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6138 sum of absolute DCT transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6139 .IPs "4 (PSNR)"
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6140 sum of squared quantization errors (avoid, low quality)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6141 .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
6142 number of bits needed for the block
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6143 .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
6144 rate distortion optimal, slow
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6145 .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
6146 0
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
6147 .IPs "8 (VSAD)"
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6148 sum of absolute vertical differences
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
6149 .IPs "9 (VSSE)"
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
6150 sum of squared vertical differences
12593
michael
parents: 12581
diff changeset
6151 .IPs "10 (NSSE)"
michael
parents: 12581
diff changeset
6152 noise preserving sum of squared differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
6153 .IPs +256\
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6154 Also use chroma, currently does not work (correctly) with B-frames.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6155 .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
6156 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6157 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6158 .TP
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6159 .B ildctcmp=<0\-2000>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6160 Sets the comparison function for interlaced DCT decision
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6161 (see mbcmp for available comparison functions).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6162 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6163 .TP
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6164 .B precmp=<0\-2000>
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6165 Sets the comparison function for motion estimation pre pass
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6166 (see mbcmp for available comparison functions) (default: 0).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6167 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6168 .TP
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6169 .B cmp=<0\-2000>
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6170 Sets the comparison function for full pel motion estimation
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6171 (see mbcmp for available comparison functions) (default: 0).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6172 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6173 .TP
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6174 .B subcmp=<0\-2000>
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6175 Sets the comparison function for sub pel motion estimation
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6176 (see mbcmp for available comparison functions) (default: 0).
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6177 .
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6178 .TP
12607
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
6179 .B nssew=<0\-100>
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6180 This setting controls NSSE weight, where larger weights will result in
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6181 more noise.
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6182 0 NSSE is identical to SSE
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6183 You may find this useful if you prefer to keep some noise in your encoded
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6184 video rather than filtering it away before encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6185 .
12593
michael
parents: 12581
diff changeset
6186 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6187 .B predia=<-99\-6>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6188 diamond type and size for motion estimation pre-pass
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
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6191 .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
6192 Diamond type & size for motion estimation.
13417
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6193 Motion search is an iterative process.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6194 Using a small diamond does not limit the search to finding only small
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6195 motion vectors.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6196 It is just somewhat more likely to stop before finding the very best motion
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6197 vector, especially when noise is involved.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6198 Bigger diamonds allow a wider search for the best motion vector, thus are
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6199 slower but result in better quality.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6200 .br
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6201 Big normal diamonds are better quality than shape-adaptive diamonds.
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6202 .br
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6203 Shape-adaptive diamonds are a good tradeoff between speed and quality.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6204 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6205 .I NOTE:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6206 The sizes of the normal diamonds and shape adaptive ones do not have
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6207 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
6208 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6209 .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
6210 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
6211 .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
6212 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
6213 .IPs -1
13417
7b9b0facc00a Better description of lavc's dia encoding option, thanks to Loren Merritt
gpoirier
parents: 13416
diff changeset
6214 slightly special: Can be slower and/or better than dia=-2.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6215 .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
6216 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
6217 .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
6218 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6219 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
6220 000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6221 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
6222 .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
6223 .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
6224 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
6225 .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
6226 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6227 0
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6228 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
6229 00000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6230 000
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6231 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
6232 .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
6233 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6234 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6235 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6236 .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
6237 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
6238 This will find the optimal encoding for each 8x8 block.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6239 Trellis searched quantization is quite simply an optimal quantization in
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6240 the PSNR versus bitrate sense (Assuming that there would be no rounding
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6241 errors introduced by the IDCT, which is obviously not the case.).
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6242 It simply finds a block for the minimum of error and lambda*bits.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6243 .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
6244 .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
6245 .IPs lambda
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6246 quantization parameter (QP) dependent constant
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
6247 .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
6248 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
6249 .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
6250 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
6251 .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
6252 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6253 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6254 .TP
10963
michael
parents: 10917
diff changeset
6255 .B cbp\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6256 Rate distorted optimal coded block pattern.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6257 Will select the coded block pattern which minimizes distortion + lambda*rate.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6258 This can only be used together with trellis quantization.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6259 .
10963
michael
parents: 10917
diff changeset
6260 .TP
10974
michael
parents: 10969
diff changeset
6261 .B mv0\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6262 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
6263 This has no effect if mbd=0.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6264 .
10974
michael
parents: 10969
diff changeset
6265 .TP
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6266 .B qprd (mbd=2 only)
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
6267 rate distorted optimal quantization parameter (QP) for the given
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6268 lambda of each macroblock
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6269 .
11446
michael
parents: 11443
diff changeset
6270 .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
6271 .B last_pred=<0\-99>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6272 amount of motion predictors from the previous frame
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6273 .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
6274 .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
6275 .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
6276 (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
6277 .IPs a
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6278 Will use 2a+1 x 2a+1 macroblock square of motion vector predictors from the
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6279 previous frame.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6280 .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
6281 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6282 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6283 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
6284 .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
6285 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
6286 .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
6287 .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
6288 .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
6289 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
6290 .IPs 1
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6291 only after I-frames (default)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6292 .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
6293 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
6294 .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
6295 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6296 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6297 .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
6298 .B subq=<1\-8>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6299 subpel refinement quality (for qpel) (default: 8 (high quality))
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6300 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6301 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6302 This has a significant effect on speed.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6303 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6304 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6305 .B psnr\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6306 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
6307 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
6308 Returned values are in dB (decibel), the higher the better.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6309 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6310 .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
6311 .B mpeg_quant
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6312 Use MPEG quantizers instead of H.263.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6313 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6314 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6315 .B aic\ \ \ \
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6316 ac prediction (advanced intra prediction for H.263+)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
6317 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6318 .I NOTE:
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6319 vqmin should be 8 or larger for H.263+ AIC.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6320 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6321 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6322 .B aiv\ \ \ \
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6323 alternatice inter vlc for H.263+
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6324 .
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
6325 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6326 .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
6327 unlimited MVs (H.263+ only)
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6328 Allows encoding of abritarily long MVs.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6329 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6330 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6331 .B ibias=<-256\-256>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6332 intra quantizer bias (256 equals 1.0, MPEG style quantizer default: 96,
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6333 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
6334 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6335 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6336 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
6337 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
6338 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6339 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6340 .B pbias=<-256\-256>
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6341 inter quantizer bias (256 equals 1.0, MPEG style quantizer default: 0,
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6342 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
6343 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6344 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6345 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
6346 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
6347 .br
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6348 .I HINT:
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6349 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
6350 .
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6351 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6352 .B nr=<0\-100000>
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6353 Noise reduction, 0 means disabled.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6354 .
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
6355 .TP
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6356 .B qns=<0\-3>
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6357 Quantizer noise shaping.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6358 Rather than choosing quantization to most closely match the source video
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6359 in the PSNR sense, it chooses quantization such that noise (usually ringing)
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6360 will be masked by similar-frequency content in the image.
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
6361 Larger values are slower but may not result in better quality.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6362 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
6363 the trellis quantization (optimal for constant weight) will be used as
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6364 startpoint for the iterative search.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6365 .PD 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6366 .RSs
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6367 .IPs 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6368 disabled (default)
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6369 .IPs 1
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6370 Only lower the absolute value of coefficients.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6371 .IPs 2
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6372 Only change coefficients before the last non-zero coefficient + 1.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6373 .IPs 3
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6374 Try all.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6375 .RE
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6376 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6377 .
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
6378 .TP
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6379 .B inter_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6380 Use custom inter matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6381 It needs a comma separated string of 64 integers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6382 .
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6383 .TP
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
6384 .B intra_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6385 Use custom intra matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
6386 It needs a comma separated string of 64 integers.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6387 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6388 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6389 .B vqmod_amp
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6390 experimental quantizer modulation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6391 .
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6392 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6393 .B vqmod_freq
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
6394 experimental quantizer modulation
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6395 .
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6396 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6397 .B dc\ \ \ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6398 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
6399 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
6400 .
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6401 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
6402 .B cgop\ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
6403 Close all GOPs.
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6404 Currently it does not work.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6405 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6406 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6407 .SS nuv (\-nuvopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6408 .
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6409 Nuppel video is based on RTJPEG and LZO.
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6410 By default frames are first encoded with RTJPEG and then compressed with LZO,
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6411 but it is possible to disable either or both of the two passes.
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6412 As a result, you can in fact output raw i420, LZO compressed i420, RTJPEG,
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6413 or the default LZO compressed RTJPEG.
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6414 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6415 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
6416 The nuvrec documentation contains some advice and examples about the
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6417 settings to use for the most common TV encodings.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6418 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6419 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6420 .B c=<0\-20>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6421 chrominance threshold (default: 1)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6422 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6423 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6424 .B l=<0\-20>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6425 luminance threshold (default: 1)
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6426 .
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6427 .TP
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6428 .B lzo\ \ \ \
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6429 Enable LZO compression (default).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6430 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6431 .TP
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6432 .B nolzo\ \
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6433 Disable LZO compression.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6434 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6435 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6436 .B q=<3\-255>
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6437 quality level (default: 255)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6438 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
6439 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
6440 .B raw \ \ \
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6441 Disable RTJPEG encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6442 .
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
6443 .TP
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
6444 .B rtjpeg\
13689
b3dda9a51760 Spelling/wording/clarity improvements and bug fixes.
diego
parents: 13679
diff changeset
6445 Enable RTJPEG encoding (default).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6446 .
13176
c73c708ad7f3 Small changes for added consistency.
diego
parents: 13175
diff changeset
6447 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
6448 .SS xvidenc (\-xvidencopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6449 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6450 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
6451 2pass.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6452 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6453 .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
6454 .B pass=<1|2>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6455 Specify the pass in 2pass mode.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6456 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6457 .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
6458 .B bitrate=<value>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6459 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
6460 if >16000.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6461 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
6462 (in kbytes) of the video and compute the associated bitrate automagically.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6463 (CBR or 2pass mode, default: 687 kbits/\:s)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6464 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6465 .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
6466 .B fixed_quant=<1\-31>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6467 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
6468 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6469 .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
6470 .B me_quality=<0\-6>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6471 This option controls the motion estimation subsystem.
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6472 The higher the value, the more precise the estimation should be (default: 6).
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6473 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
6474 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
6475 you need realtime encoding.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6476 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6477 .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
6478 .B interlacing
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6479 Encode the fields of interlaced video material.
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6480 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
6481 .br
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6482 .I NOTE:
13259
9f8b314406c2 MB, QP explanation, some more consistency
diego
parents: 13257
diff changeset
6483 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
6484 which you can activate with -vf scale=<width>:<height>:1.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6485 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6486 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6487 .B 4mv\ \ \ \
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6488 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
6489 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
6490 .br
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6491 .I WARNING:
13257
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6492 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
6493 by the me_quality option.
9e8b984a39a5 More information on XviD's "interlaced" and "4mv" options thanks to a
gpoirier
parents: 13247
diff changeset
6494 When me_quality > 4, 4mv is activated.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6495 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6496 .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
6497 .B rc_reaction_delay_factor=<value>
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6498 This parameter controls the number of frames the CBR rate controller
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6499 will wait before reacting to bitrate changes and compensating for them
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6500 to obtain a constant bitrate over an averaging range of frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6501 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6502 .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
6503 .B rc_averaging_period=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6504 Real CBR is hard to achieve.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6505 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
6506 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
6507 amount of bits (minus a small variation).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6508 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
6509 bitrate and tries to achieve CBR.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6510 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6511 .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
6512 .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
6513 size of the rate control buffer
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6514 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6515 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6516 .B quant_range=<1\-31>\-<1\-31>[/\:<1\-31>\-<1\-31>]
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6517 CBR mode: min & max quantizer for all frames (default: 2\-31)
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
6518 .br
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6519 2pass mode: min & max quantizer for I/\:P-frames (default: 2\-31/\:2\-31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6520 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6521 .I WARNING:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6522 This option is deprecated in XviD-1.0.x, and is replaced by the
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6523 [min|max]_[i|p|b]quant options.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6524 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6525 .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
6526 .B min_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6527 minimum interval between keyframes (default: 0, 2pass only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6528 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6529 .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
6530 .B max_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6531 maximum interval between keyframes (default: 10*fps)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6532 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6533 .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
6534 .B mpeg_quant
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6535 Use MPEG quantizers instead of H.263.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6536 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
6537 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
6538 When using custom matrices, MPEG must be used.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6539 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6540 .I WARNING:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6541 This option is deprecated in XviD-1.0.x, and is replaced by the quant_type
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6542 option.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6543 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6544 .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
6545 .B mod_quant
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6546 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6547 (2pass mode only).
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6548 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6549 .I WARNING:
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6550 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
6551 by any MPEG4 decoder besides libavcodec or XviD.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6552 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6553 .I WARNING:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6554 This option is deprecated in XviD-1.0.x.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6555 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6556 .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
6557 .B keyframe_boost=<0\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6558 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
6559 thus improving keyframe quality.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6560 (default: 0, 2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6561 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6562 .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
6563 .B kfthreshold=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6564 (default: 10, 2pass mode only)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6565 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6566 .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
6567 .B kfreduction=<0\-100>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6568 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
6569 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
6570 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
6571 kfreduction determines the bitrate reduction they get.
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6572 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
6573 (default: 30, 2pass mode only)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6574 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6575 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6576 .B greyscale
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6577 Make XviD discard chroma planes so the encoded video is greyscale only.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6578 Note that this does not speed up encoding, it just prevents chroma data
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6579 from being written in the last stage of encoding.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6580 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6581 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6582 .B debug\ \
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6583 Save per-frame statistics in ./xvid.dbg. (This is not the 2pass control
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6584 file.)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
6585 .RE
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6586 .
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
6587 .PP
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
6588 .sp 1
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
6589 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
6590 releases of XviD 1.0.x (api4).
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6591 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6592 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6593 .B packed\
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
6594 Create a bitstream which can be decoded delay-free.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
6595 .br
9818
rguyom
parents: 9809
diff changeset
6596 .I WARNING:
13635
d785f4cd68c7 man page review part XI
diego
parents: 13626
diff changeset
6597 This will generate an illegal bitstream, and will not be
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6598 decodable by ISO-MPEG4 decoders except DivX/\:libavcodec/\:XviD.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
6599 .br
9818
rguyom
parents: 9809
diff changeset
6600 .I WARNING:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
6601 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
6602 autodetection of some decoders might be confused.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6603 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6604 .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
6605 .B divx5bvop
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6606 Generate DivX5 compatible B-frames (default: on).
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6607 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6608 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6609 .B max_bframes=<0\-4>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6610 Maximum number of B-frames to put between I/\:P-frames (default: 0).
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6611 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6612 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6613 .B bquant_ratio=<0\-1000>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6614 quantizer ratio between B- and non-B-frames, 150=1.50 (default: 150)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6615 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6616 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6617 .B bquant_offset=<-1000\-1000>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6618 quantizer offset between B- and non-B-frames, 100=1.00 (default: 100)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6619 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6620 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6621 .B bf_threshold=<-255\-255>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6622 Sometimes B-frames do not look good, and introduce artifacts when most of
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6623 the frame is static and some small zones have high motion (in a static
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6624 scene with a man talking, his mouth will probably look bad if what is
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6625 surrounding the man and his mouth is completely static).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6626 This setting allows you to specify what priority to place on the use of
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6627 B-frames.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6628 The higher the value, the higher the probability of B-frames being used.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6629 (default: 0)
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6630 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6631 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6632 .B frame_drop_ratio=<0\-100> (max_bframes=0 only)
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6633 This setting allows the creation of variable framerate video streams.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6634 The value of the setting specifies a threshold under which, if the
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6635 difference of the following frame to the previous frame is below or equal
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6636 to this threshold, a frame gets not coded (a so called n-vop is placed
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6637 in the stream).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6638 On playback, when reaching an n-vop the previous frame will be displayed.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6639 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6640 .I WARNING:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6641 Playing with this setting may result in a jerky video, so use it at your
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6642 own risks!
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6643 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6644 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6645 .B qpel\ \ \
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6646 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
6647 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
6648 pixel precision.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6649 This option usually results in a sharper image.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6650 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
6651 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
6652 quality at a fixed bitrate.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6653 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
6654 is worth activating.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6655 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6656 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6657 .B gmc\ \ \ \
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6658 Enable Global Motion Compensation, which makes XviD generate special
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6659 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
6660 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
6661 dependent on the source material.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6662 .
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6663 .TP
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6664 .B trellis
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6665 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
6666 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
6667 compressible by the entropy encoder.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6668 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
6669 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
6670 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
6671 .
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6672 .TP
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6673 .B cartoon
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6674 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
6675 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
6676 frame types and motion vectors for flat looking cartoons.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6677 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6678 .TP
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6679 .B quant_type=<h263|mpeg>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6680 Sets the type of quantizer to use.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6681 For high bitrates, you will find that MPEG quantization preserves more detail.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6682 For low bitrates, the smoothing of H.263 will give you less block noise.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6683 When using custom matrices, MPEG quantization must be used.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6684 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6685 .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
6686 .B chroma_me
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6687 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
6688 find the best motion vector.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6689 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
6690 better vectors.
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6691 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
6692 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6693 .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
6694 .B chroma_opt
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
6695 Enable a chroma optimizer prefilter.
13053
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6696 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
6697 stepped-stairs effect on edges.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6698 It will improve quality at the cost of encoding speed.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
6699 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
6700 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
6701 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
6702 encoding in greyscale.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6703 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6704 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6705 .B hq_ac\ \
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6706 Activates High Quality AC coefficient prediction from neighbor blocks.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6707 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6708 .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
6709 .B vhq=<0\-4>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6710 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
6711 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
6712 reference frame and the encoded frame.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
6713 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
6714 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
6715 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
6716 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
6717 .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
6718 .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
6719 .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
6720 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
6721 .IPs 1
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6722 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
6723 .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
6724 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
6725 .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
6726 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
6727 .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
6728 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
6729 .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
6730 .PD 1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6731 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
6732 .TP
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6733 .B min_iquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6734 minimum I-frame quantizer (default: 2)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6735 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6736 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6737 .B max_iquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6738 maximum I-frame quantizer (default: 31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6739 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6740 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6741 .B min_pquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6742 minimum P-frame quantizer (default: 2)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6743 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6744 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6745 .B max_pquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6746 maximum P-frame quantizer (default: 31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6747 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6748 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6749 .B min_bquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6750 minimum B-frame quantizer (default: 2)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6751 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6752 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6753 .B max_bquant=<0\-31>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6754 maximum B-frame quantizer (default: 31)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6755 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6756 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6757 .B quant_intra_matrix=<filename>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6758 Load a custom intra matrix file.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6759 You can build such a file with xvid4conf's matrix editor.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6760 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6761 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6762 .B quant_inter_matrix=<filename>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6763 Load a custom inter matrix file.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6764 You can build such a file with xvid4conf's matrix editor.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6765 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6766 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6767 .B curve_compression_high=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6768 This setting allows XviD to take a certain percentage of bits away from
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6769 high bitrate scenes and give them back to the bit reservoir.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6770 You could also use this if you have a clip with so many bits allocated
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6771 to high-bitrate scenes that the low(er)-bitrate scenes start to look bad
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6772 (default: 0).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6773 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6774 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6775 .B curve_compression_low=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6776 This setting allows XviD to give a certain percentage of extra bits to the
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6777 low bitrate scenes, taking a few bits from the entire clip.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6778 This might come in handy if you have a few low-bitrate scenes that are
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6779 still blocky (default: 0).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6780 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6781 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6782 .B overflow_control_strength=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6783 During pass 1 of 2-pass encoding, a scaled bitrate curve is computed.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6784 The difference between that expected curve and the result obtained during
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6785 encoding is called overflow.
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6786 Obviously, the two pass rate controller tries to compensate for that overflow,
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6787 distributing it over the next frames.
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6788 This setting controls how much of the overflow is distributed every time
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6789 there is a new frame.
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6790 Low values allow lazy overflow control, big rate bursts are compensated for
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6791 more slowly (could lead to lack of precision for small clips).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6792 Higher values will make changes in bit redistribution more abrupt, possibly
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6793 too abrupt if you set it too high, creating artifacts (default: 5).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6794 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6795 .I NOTE:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6796 This setting impacts quality a lot, play with it carefully!
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6797 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6798 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6799 .B max_overflow_improvement=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6800 During the frame bit allocation, overflow control may increase the frame
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6801 size.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6802 This parameter specifies the maximum percentage by which the overflow
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6803 control is allowed to increase the frame size, compared to the ideal curve
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6804 allocation
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6805 (default: 5).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6806 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6807 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6808 .B max_overflow_degradation=<0\-100>
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6809 During the frame bit allocation, overflow control may decrease the frame
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6810 size.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6811 This parameter specifies the maximum percentage by which the overflow
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6812 control is allowed to decrease the frame size, compared to the ideal curve
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6813 allocation
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6814 (default: 5).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6815 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6816 .TP
13691
e8d4f3ed7509 man page review part XII
diego
parents: 13690
diff changeset
6817 .B container_frame_overhead=<0...>
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6818 Specifies a frame average overhead per frame, in bytes.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6819 Most of the time users express their target bitrate for video w/o taking
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6820 care of the video container overhead.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6821 This small but (mostly) constant overhead can cause the target file size
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6822 to be exceeded.
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6823 XviD allows users to set the amount of overhead per frame the
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6824 container generates (give only an average per frame).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6825 0 has a special meaning, it lets XviD use its own default values
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6826 (default: 24 - AVI average overhead).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6827 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6828 .TP
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6829 .B par=<mode>
13286
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6830 Specifies the Pixel Aspect Ratio mode (not to be confused with DAR,
cf3c4a53df30 Typos on the XviD section
gpoirier
parents: 13282
diff changeset
6831 the Display Aspect Ratio).
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6832 PAR is the ratio of the width and height of a single pixel.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6833 So both are related like this: DAR = PAR * (width/height).
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6834 .br
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6835 MPEG4 defines 5 pixel aspect ratios and one extended
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6836 one, giving the opportunity to specify a specific pixel aspect
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6837 ratio.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6838 5 standard modes can be specified:
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6839 .PD 0
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6840 .RSs
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6841 .IPs vga11
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6842 It's the usual PAR for PC content.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6843 Pixels are a square unit.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6844 .IPs pal43
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6845 PAL standard 4:3 PAR.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6846 Pixels are rectangles.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6847 .IPs pal169
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6848 same as above
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6849 .IPs ntsc43
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6850 same as above
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6851 .IPs ntsc169
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6852 same as above (Don't forget to give the exact ratio.)
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6853 .IPs ext\ \
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6854 Allows you to specify your own pixel aspect ratio with par_width and
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6855 par_height.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6856 .RE
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6857 .PD 1
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6858 .br
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
6859 .I NOTE:
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6860 In general, setting aspect and autoaspect options is enough.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6861 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6862 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
6863 .B par_width=<1\-255> (par=ext only)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6864 Specifies the width of the custom pixel aspect ratio.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6865 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6866 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
6867 .B par_height=<1\-255> (par=ext only)
13282
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6868 Specifies the height of the custom pixel aspect ratio.
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6869 .
a46dce85af0a Big changes on XviD documentation.
gpoirier
parents: 13274
diff changeset
6870 .TP
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6871 .B aspect=<x/\:y | f (float value)>
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6872 Store movie aspect internally, just like MPEG files.
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6873 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
6874 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
6875 will display them with the wrong aspect.
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6876 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
6877 .
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6878 .TP
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6879 .B autoaspect
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6880 Same as the aspect option, but automatically computes aspect, taking
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
6881 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
6882 filter chain.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6883 .
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
6884 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
6885 .B psnr\ \ \
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
6886 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
6887 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
6888 the current directory.
9809
508dc4231269 Actually do something useful with XVID_GLOBAL_EXTRASTATS / XVID_EXTRASTATS.
rguyom
parents: 9808
diff changeset
6889 Returned values are in dB (decibel), the higher the better.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6890 .
13613
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6891 .PP
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6892 .sp 1
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6893 The following option is only available in development versions
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6894 of XviD 1.1.x.
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6895 .
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6896 .TP
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6897 .B bvhq=<0|1>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6898 This setting allows vector candidates for B-frames to be used for
13613
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6899 the encoding chosen using a rate distortion optimized operator,
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6900 which is what is done for P-frames by the vhq option.
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6901 This produces nicer-looking B-frames while incurring almost no
13613
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6902 performance penalty.
3175ee359092 XviD's bvhq option description
gpoirier
parents: 13601
diff changeset
6903 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6904 .
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
6905 .SS x264enc (\-x264encopts)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6906 .
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
6907 .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
6908 .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
6909 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
6910 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
6911 .
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
6912 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6913 .B keyint=<value>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6914 Sets maximum interval between I-frames.
13456
25519a9feab0 Better x264 descriptions/fixes based on Loren Merritt's patch (Thu, 23 Sep 2004)
gpoirier
parents: 13452
diff changeset
6915 Larger values save bits, thus improve quality, at the cost of seeking
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6916 precision (default: 250).
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6917 .
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6918 .TP
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6919 .B idrint=<value>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6920 Make each <value> I-frame an IDR-frame (default: 2).
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6921 In H.264, I-frames do not necessarily bound a closed GOP because it is
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6922 allowable for a P-frame to be predicted from more frames than just the one
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6923 frame before it (also see frameref).
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6924 Therefore, I-frames are not necessarily seekable.
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6925 IDR-frames restrict subsequent P-frames from referring to any frame
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6926 prior to the IDR-frame.
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6927 .
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6928 .TP
13584
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6929 .B scenecut=<-1\-100>
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6930 Controls how aggressively to insert extra I-frames (default: 40).
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6931 With small values of scenecut, the codec often has to force an I-frame
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6932 when it would exceed keyint.
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6933 Good values of scenecut may find a better location for the I-frame.
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6934 Large values use more I-frames than necessary, thus wasting bits.
13589
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6935 -1 disables scene-cut detection, so I-frames are inserted only once
b158faf16c92 consistency fix, typos and better wording as suggested by Loren Merritt
diego
parents: 13586
diff changeset
6936 every other keyint frames, even if a scene-cut occurs earlier.
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6937 This isn't recommended and wastes bitrate as scenecuts encoded as P-frames
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
6938 are just as big as I-frames, but don't reset the "keyint counter".
13584
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6939 .
17cb9c6a99f6 Adds a parameter 'scenecut', to control the threshold for inserting extra I-frames.
iive
parents: 13562
diff changeset
6940 .TP
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6941 .B frameref=<1\-15>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6942 Number of previous frames used as predictors in a P-frame (default: 1).
13495
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6943 This is effective in Anime, but seems to make little difference in
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6944 live-action source material.
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6945 Some decoders are unable to deal with large frameref values.
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6946 .
2074e959b32c This reverts the x264 modifications to the man page suggested my Loren, and
gpoirier
parents: 13494
diff changeset
6947 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6948 .B bframes=<0\-16>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
6949 number of consecutive B-frames between I- and P-frames (default: 0)
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6950 .
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6951 .TP
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6952 .B deblock | nodeblock
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6953 Use deblocking filter (default: on).
13472
c85ea936d411 Encoding tip regarding x264's deblock filter suggested by Loren Merritt.
gpoirier
parents: 13469
diff changeset
6954 As it takes very little time compared to its quality gain, it's not
c85ea936d411 Encoding tip regarding x264's deblock filter suggested by Loren Merritt.
gpoirier
parents: 13469
diff changeset
6955 recommend to disable it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6956 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
6957 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
6958 .B deblockalpha=<-6\-6>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6959 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
6960 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
6961 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
6962 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
6963 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
6964 edge being filtered.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6965 A positive value reduces blocking artifacts more, but will also smear details.
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6966 .br
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6967 For encodes that are intended to be reasonably high quality, you might
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6968 want to turn it down a little bit.
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6969 However, if your source material already has some blocking or noise
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6970 which you would like to remove, or if it is animation, it may be a good
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
6971 idea to turn it up a little bit.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6972 .
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
6973 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
6974 .B deblockbeta=<-6\-6>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6975 Beta parameter of deblocking filter (default: 0).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6976 Affects the maximum allowed gradient within two adjacent blocks.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6977 .
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
6978 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6979 .B cabac | nocabac
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6980 Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: on).
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6981 Slightly slows down encoding and decoding, but should save 10-15% bitrate.
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
6982 Unless you are looking for speed, you should not disable it.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
6983 .
13177
02580e91602f trailing whitespace
diego
parents: 13176
diff changeset
6984 .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
6985 .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
6986 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
6987 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
6988 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
6989 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
6990 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
6991 .RSs
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
6992 -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
6993 .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
6994 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
6995 .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
6996 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
6997 .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
6998 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
6999 .REss
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7000 .
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
7001 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7002 .B qp_constant=<1\-51>
13166
d198f255bee9 x264 encoder support. Original patch send by Bernhard Rosenkraenzer <bero at arklinux dot org>, modifications by Loren Merritt <lorenm at u.washington dot edu>, Jeff Clagg <snacky at ikaruga.co dot uk> and me
iive
parents: 13160
diff changeset
7003 This selects the quantizer to use.
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7004 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
7005 Lower values result in better fidelity, but higher bitrates.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7006 Note that quantization in H.264 works differently from MPEG[124].
13469
b91363d97bf7 quantizer --> quantization as pointed out by Attila
diego
parents: 13468
diff changeset
7007 H.264's quantization parameter (QP) is on a logarithmic scale.
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7008 As an example, the bitrate difference between QP=20 and QP=40
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7009 is about a factor of 10.
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7010 Useful quantizers in H.264 tend to be very large compared to MPEG[124].
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7011 .
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
7012 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7013 .B qp_min=<1\-51> (CBR or 2 pass)
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7014 Minimum quantizer, 15\-35 seems to be a useful range (default: 10).
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7015 .
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7016 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7017 .B qp_max=<1\-51> (CBR or 2 pass)
13325
f26d2c9aec04 2pass encoding support for x264(r46).
iive
parents: 13319
diff changeset
7018 maximum quantizer (default: 51)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7019 .
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
7020 .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
7021 .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
7022 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
7023 frames.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7024 .
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
7025 .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
7026 .B rc_buffer_size=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7027 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
7028 specified)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7029 .
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
7030 .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
7031 .B rc_init_buffer=<value>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7032 Set the initial ratecontrol buffer (default: 1/4 of rc_buffer_size)
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7033 .
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7034 .TP
13456
25519a9feab0 Better x264 descriptions/fixes based on Loren Merritt's patch (Thu, 23 Sep 2004)
gpoirier
parents: 13452
diff changeset
7035 .B rc_sens=<0\-100> (CBR only)
13325
f26d2c9aec04 2pass encoding support for x264(r46).
iive
parents: 13319
diff changeset
7036 ratecontrol sensitivity (default: 4)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7037 .
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
7038 .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
7039 .B ip_factor=<value>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7040 quantizer factor between I- and P-frames (default: 2.0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7041 .
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
7042 .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
7043 .B pb_factor=<value>
13690
91faa5745914 consistent I/P/B-frame spelling
diego
parents: 13689
diff changeset
7044 quantizer factor between P- and B-frames (default: 2.0)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7045 .
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
7046 .TP
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7047 .B pass=<1\-3>
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7048 Enable 2 or 3-pass mode.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7049 It is recommended to always encode in 2 or 3-pass mode as it leads to a
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7050 better bit distribution and improves overall quality.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7051 .PD 0
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7052 .RSs
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7053 .IPs 1
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7054 first pass
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7055 .IPs 2
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7056 second pass
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7057 .IPs 3
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7058 Nth pass (second and third passes of three pass encoding)
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7059 .RE
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7060 .RS
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7061 Here is how it works, and how to use it:
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7062 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7063 The first pass (pass=1) collects statistics on the video and writes them
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7064 to a file.
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
7065 You might want to deactivate some CPU-hungry options, apart from the ones
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7066 that are on by default.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7067 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7068 In two pass mode, the second pass (pass=2) reads the stats file and
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7069 bases ratecontrol decisions on it.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7070 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7071 In three pass mode, the second pass (pass=3, that is not a typo)
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7072 does both: It first reads the stats, then overwrites them.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7073 You might want to backup divx2pass.log before doing this if there is
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7074 any possibility that you will have to cancel MEncoder.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7075 You can use all encoding options, except very CPU-hungry options.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7076 .br
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7077 The third pass (pass=3) is the same as the second pass, except that it has
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7078 the second pass' stats to work from.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7079 You can use all encoding options, including CPU-hungry ones.
13525
3b989771a870 -sws and -vf scale sections improved, small fixes.
diego
parents: 13517
diff changeset
7080 .br
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7081 .I
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7082 NOTE:
13545
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7083 x264 three pass support being quite recent in MEncoder, we welcome any
13517
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7084 feedback you could give us on good combinations of x264 options that are
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7085 both fast and provide good quality.
dea5d3e8b6c1 Documentation of x264 3-pass mode, and typos/fixes on lavc's *_mask
gpoirier
parents: 13513
diff changeset
7086 .REss
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7087 .
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
7088 .TP
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7089 .B qcomp=<0\-1>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7090 quantizer compression (default: 0.6).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7091 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
7092 bitrate more constant, while a higher value makes the quantization parameter
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7093 more constant.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7094 .
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
7095 .TP
13330
dbc65c2f4610 Consistency fixes, spelling
wight
parents: 13328
diff changeset
7096 .B qblur=<0\-99>
13180
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7097 Temporal blur of the quantization parameter (default: 0.5).
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7098 Lower values allow the quantizer value to jump around more,
b55551b5898b x264 section reviewed.
diego
parents: 13179
diff changeset
7099 higher values force it to vary more smoothly.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7100 .
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
7101 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7102 .B fullinter | nofullinter
13586
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
7103 Use all available interframe macroblock types (i16x16, i4x4, p16x16,
c6e50793ccaa minor revision to improve clearness, add a comprehensive list of all
gpoirier
parents: 13585
diff changeset
7104 p16x8, p8x16, p8x8, p8x4, p4x8, p4x4, pskip)
13405
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
7105 The idea is to find the type and size that best describe a certain area
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
7106 of the picture, i.e.\& very effective for Anime, which usually contains
bb1052826a89 Better description of Loren Merritt's 3-pass mode, better qns desc., and a
gpoirier
parents: 13400
diff changeset
7107 large areas of the same color (default: i16x16, i4x4, p16x16-8x8).
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7108 Depending on the source material, it can improve or degrade quality, use
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7109 it with care.
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7110 .
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
7111 .TP
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7112 .B subq=<0\-5>
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7113 Adjust subpel refinement quality.
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7114 This parameter controls quality versus speed tradeoffs involved in the motion
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7115 estimation decision process.
13446
8e3727784de8 Encoding tips for x264 + 10l
gpoirier
parents: 13439
diff changeset
7116 It can improve quality significantly.
13431
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7117 .RSs
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7118 0: halfpel only
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7119 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7120 1: 1 iteration of qpel on the winning candidate (default)
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7121 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7122 2: 2 iterations of qpel on the winning candidate
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7123 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7124 3: halfpel on all MB types, qpel on the winner
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7125 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7126 4: qpel on all
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7127 .br
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7128 5: more iterations of qpel
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7129 .REss
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7130 .
15efa8ab93e3 add support for subpel quality refinement option in x264.
iive
parents: 13426
diff changeset
7131 .TP
13496
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7132 .B log=<-1\-3>
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7133 Adjust the amount of logging info printed to the screen.
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7134 .RSs
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7135 -1: none
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7136 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7137 0: Print errors only.
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7138 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7139 1: warnings
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7140 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7141 2: PSNR, encoding times, and other analysis stats when the encode finishes
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7142 (default)
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7143 .br
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7144 3: PSNR, QP, frametype, size, and other stats for every frame
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7145 .REss
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7146 .
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7147 .TP
0bdcb3eea569 better default parameter,added counterpart option, better names for few options, 3-pass support and improved documentation.
iive
parents: 13495
diff changeset
7148 .B psnr | nopsnr
13545
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7149 Print signal-to-noise ratio statistics.
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7150 .br
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7151 .I NOTE:
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7152 The 'Y', 'U', 'V', and 'Avg' PSNR fields in the summary are not
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7153 mathematically sound (they are simply the average of per-frame PSNRs).
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7154 They are kept only for comparison to the JM reference codec.
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7155 For all other purposes, please use either the 'Global' PSNR, or the per-frame
28ff07e2df86 Better description of x264 PSNR stats.
gpoirier
parents: 13543
diff changeset
7156 PSNRs printed by log=3.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7157 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7158 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7159 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7160 .\" Files
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7161 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7162 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7163 .SH FILES
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7164 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7165 .TP
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
7166 /usr/\:local/\:etc/\:mplayer/\:mplayer.conf
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
7167 system-wide settings
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7168 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7169 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7170 ~/.mplayer/\:config
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7171 user settings
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7172 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7173 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7174 ~/.mplayer/\:input.conf
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7175 input bindings (see '\-input keylist' for the full list)
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7176 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7177 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7178 ~/.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
7179 GUI configuration file
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7180 .
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
7181 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7182 ~/.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
7183 GUI playlist
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7184 .
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
7185 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7186 ~/.mplayer/\:font/
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7187 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
7188 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
7189 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7190 ~/.mplayer/\:DVDkeys/
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
7191 cached CSS keys
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7192 .
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
7193 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7194 Assuming that /path/\:to/\:movie.avi is played, MPlayer searches for sub files
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7195 in this order:
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
7196 .RS
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7197 /path/\:to/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
7198 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7199 ~/.mplayer/\:sub/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
7200 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7201 ~/.mplayer/\:default.sub
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
7202 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
7203 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7204 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7205 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7206 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7207 .\" Examples
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7208 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7209 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7210 .SH EXAMPLES
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7211 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7212 .TP
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
7213 .B Quickstart DVD playing:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7214 mplayer dvd://1
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7215 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7216 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7217 .B Play in Japanese with English subtitles:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7218 mplayer dvd://1 \-alang ja \-slang en
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7219 .
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
7220 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7221 .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
7222 mplayer dvd://1 \-chapter 5-7
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7223 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7224 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7225 .B Play only titles 5, 6, 7:
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
7226 mplayer dvd://5-7
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7227 .
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
7228 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7229 .B Play a multiangle DVD:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7230 mplayer dvd://1 \-dvdangle 2
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7231 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7232 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7233 .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
7234 mplayer dvd://1 \-dvd-device /dev/\:dvd2
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7235 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7236 .TP
13510
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7237 .B Play DVD video from a directory with VOB files:
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7238 mplayer dvd://1 \-dvd-device /path/\:to/\:directory/
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7239 .
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7240 .TP
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7241 .B Copy a DVD title to hard disk, saving to file "title1.vob":
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7242 mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7243 .
4dbef0d0b09e -dvd-device can point to a directory to play a VOB from the hard disk.
diego
parents: 13507
diff changeset
7244 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7245 .B Stream from HTTP:
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
7246 mplayer http://mplayer.hq/\:example.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7247 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7248 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7249 .B Stream using RTSP:
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
7250 mplayer rtsp://server.example.com/\:streamName
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7251 .
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
7252 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7253 .B Convert subtitles to MPsub format:
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
7254 mplayer dummy.avi \-sub source.sub \-dumpmpsub
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7255 .
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
7256 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7257 .B Convert subtitles to MPsub format without watching the movie:
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
7258 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
7259 \-benchmark \-sub source.sub \-dumpmpsub
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7260 .
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7261 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7262 .B input from standard V4L:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7263 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
7264 \-vo xv
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7265 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7266 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7267 .B Playback on Zoran cards (old style, deprecated):
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
7268 mplayer \-vo zr \-vf scale=352:288 file.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7269 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
7270 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7271 .B Playback on Zoran cards (new style):
13068
3a1a3e787d39 man page review part V
diego
parents: 13064
diff changeset
7272 mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7273 .
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
7274 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7275 .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
7276 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
7277 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7278 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7279 .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
7280 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
7281 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7282 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7283 .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
7284 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
7285 \-ovc lavc \-lavcopts vcodec=mpeg4
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7286 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7287 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7288 .B The same, but with bitrate set to 1800kBit and optimized macroblocks:
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7289 mencoder dvd://2 \-o title2.avi \-oac copy \-ovc lavc
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7290 \-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7291 .
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7292 .TP
13293
31bf2a3ab8c9 some typo, case change
danny
parents: 13286
diff changeset
7293 .B The same, but with MJPEG compression:
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
7294 mencoder dvd://2 \-o titel2.avi \-ovc lavc
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7295 \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 \-oac copy
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7296 .
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7297 .TP
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7298 .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
7299 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
7300 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7301 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7302 .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
7303 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
7304 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
7305 .TP
13219
f7efa10d3e91 man page review part VIII
diego
parents: 13214
diff changeset
7306 .B Encode from a pipe:
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
7307 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
7308 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7309 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7310 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7311 .\" Bugs, authors, standard disclaimer
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7312 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7313 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7314 .SH BUGS
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7315 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
7316 of the documentation first.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7317 Many bugs are the result of incorrect setup or parameter usage.
13142
96f4bd75fcb0 Add \: after /
wight
parents: 13135
diff changeset
7318 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
7319 explains how to create useful bug reports.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7320 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
7321 .
13175
09b0bfb42d6d Consistently insert lines with only "." between options.
diego
parents: 13166
diff changeset
7322 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
7323 .SH AUTHORS
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7324 MPlayer was initially written by Arpad Gereffy.
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7325 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
7326 .PP
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7327 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
7328 .PP
13179
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7329 This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
53a20c9d1ce9 more consistency, small changes
diego
parents: 13177
diff changeset
7330 It is maintained by Diego Biurrun.
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
7331 Please send mails about it to the MPlayer-DOCS mailing list.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
7332 .\" end of file