annotate DOCS/man/en/mplayer.1 @ 13053:d59a2274442c

better description of the chroma_opt XviD option patch by Guillaume POIRIER <gpoirier@irisa.fr>
author diego
date Thu, 19 Aug 2004 14:45:07 +0000
parents 27c1f3ae682e
children 29d8052f48f7
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 .
12645
3841ef14a481 name change
diego
parents: 12621
diff changeset
36 .TH MPlayer 1 "2004-01-16" "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\ | \ \-\ ]
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
52 .br
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
53 .B mplayer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
54 'in +\n[.k]u
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
55 [global options]
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
56 .I file1
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
57 [specific options] [file2] [specific options]
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
58 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
59 .in
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
60 .B mplayer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
61 'in +\n[.k]u
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
62 [global options]
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
63 .RI { "group of files and options" }
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
64 [group specific options]
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
65 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
66 .in
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
67 .B mplayer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
68 'in +\n[.k]u
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
69 .I dvd://[title | [start_title]\-end_title ]
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
70 [options]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
71 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
72 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
73 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
74 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
75 .I vcd://track[/device]
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
76 .br
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
77 .in
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
78 .B mplayer
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
79 'in +\n[.k]u
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
80 .I tv://[channel]
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
81 [options]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
82 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
83 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
84 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
85 'in +\n[.k]u
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
86 .I dvb://[card_number@]channel
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
87 [options]
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
88 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
89 .in
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
90 .B mplayer
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
91 'in +\n[.k]u
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
92 .I mf://filemask
12402
b0f31de74374 Hint at -mf in mf:// syntax description.
diego
parents: 12389
diff changeset
93 [-mf options] [options]
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
94 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
95 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
96 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
97 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
98 .I [cdda|cddb]://track[:speed][/device]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
99 [options]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
100 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
101 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
102 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
103 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
104 .I cue://file[:track]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
105 [options]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
106 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
107 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
108 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
109 'in +\n[.k]u
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
110 .RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] ://
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
111 [user:passwd@]\fIURL\fP[:port] [options]
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
112 .br
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
113 .in
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
114 .B mplayer
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
115 'in +\n[.k]u
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
116 .I sdp://file
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
117 [options]
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
118 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
119 .in
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
120 .B mplayer
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
121 'in +\n[.k]u
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
122 .I mpst://host[:port]/URL
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
123 [options]
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
124 .br
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
125 .in
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
126 .B gmplayer
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
127 [options]
12558
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
128 [\-skin\ skin]
2f8de6558792 SYNOPSIS reordered.
diego
parents: 12549
diff changeset
129 .br
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
130 .B mencoder
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
131 [options]
11115
10972fd355bf stdin should also be \-, forgotten \.
diego
parents: 11103
diff changeset
132 .RI [ \ file\ | \ URL\ | \ \-\ ]
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
133 [\-o\ file]
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
134 .ad
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
135 .hy
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
136 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
137 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
138 .\" Description
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
139 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
140 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
141 .SH DESCRIPTION
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
142 .B mplayer
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
143 is a movie player for Linux (runs on many other platforms and CPU
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
144 architectures, see the documentation).
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
145 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
146 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
147 native and binary codecs.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
148 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
149 too.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
150 .PP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
151 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
152 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
153 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
154 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
155 (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
156 Siemens DVB, DXR2 and DXR3/\:Hollywood+.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
157 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
158 fullscreen mode.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
159 .PP
6573
7663637ddba4 OSD == onscreen display, typos
diego
parents: 6469
diff changeset
160 MPlayer has an onscreen display (OSD) for status information, nice big
7663637ddba4 OSD == onscreen display, typos
diego
parents: 6469
diff changeset
161 antialiased shaded subtitles and visual feedback for keyboard controls.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
162 European/\:ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
12823
6026e1e566f7 Number of subtitles corrected.
diego
parents: 12816
diff changeset
163 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
11873
9c66ef56b1b1 Fix the PJS (aka dunnowhat) subtitles
attila
parents: 11858
diff changeset
164 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
165 DVD subtitles (SPU streams, VOBsub and Closed Captions).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
166 .PP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
167 .B mencoder
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
168 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
169 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
170 below).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
171 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
172 audio in 1, 2 or 3\ passes.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
173 Furthermore it has stream copying abilities, a powerful filter system (crop,
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
174 expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
175 more.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
176 .PP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
177 .B gmplayer
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
178 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
179 It has the same options as MPlayer.
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
180 .PP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
181 .B Also see the HTML documentation!
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
182 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
183 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
184 .\" --------------------------------------------------------------------------
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
185 .\" Keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
186 .\" --------------------------------------------------------------------------
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
187 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
188 .SH "KEYBOARD CONTROL"
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
189 MPlayer has a fully configurable, command-driven control layer
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
190 which allows you to control MPlayer using keyboard, mouse, joystick
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
191 or remote control (with LIRC).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
192 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
193 The default configuration file for the input system is
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
194 ~/.mplayer/\:input.conf but it can be overriden
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
195 using the \-input option.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
196 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
197 .B general control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
198 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
199 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
200 .IPs "<\- and \->"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
201 seek backward/\:forward 10 seconds
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
202 .IPs "up and down"
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
203 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
204 .IPs "pgup and pgdown"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
205 seek backward/\:forward 10 minutes
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
206 .IPs "< and >"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
207 backward/\:forward in playlist
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
208 .IPs "HOME and END"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
209 go to next/\:previous playtree entry in the parent list
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
210 .IPs "INS and DEL"
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
211 go to 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
212 .IPs "p / SPACE"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
213 pause movie (any key unpauses)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
214 .IPs "q / ESC"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
215 stop playing and quit
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
216 .IPs "+ and -"
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
217 adjust audio delay by +/\:- 0.1 second
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
218 .IPs "/ and *"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
219 decrease/\:increase volume
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
220 .IPs "9 and 0"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
221 decrease/\:increase volume
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
222 .IPs m\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
223 mute sound
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
224 .IPs f\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
225 toggle fullscreen
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
226 .IPs T\ \ \ \
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
227 toggle stay-on-top.
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
228 Supported by video out drivers which use X11, except SDL, as well as directx
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
229 and gl2 under Windows.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
230 .IPs "w and e"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
231 decrease/\:increase panscan range
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
232 .IPs o\ \ \ \
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
233 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
234 .IPs d\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
235 toggle frame dropping states: none / skip display / skip decoding
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
236 (see \-framedrop and \-hardframedrop)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
237 .IPs v\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
238 toggle subtitle visibility
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
239 .IPs j\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
240 switch subtitle language
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
241 .IP F\ \ \ \
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
242 toggle display of "forced subtitles"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
243 .IPs a\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
244 toggle subtitle aligment: top/middle/bottom
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
245 .IPs "z and x"
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
246 adjust subtitle delay by +/\:- 0.1 second
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
247 .IPs "r and t"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
248 adjust subtitle position
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
249 .IPs i\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
250 set EDL mark
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
251 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
252 .PD 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
253 .PP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
254 (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
255 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
256 (\-vf eq or \-vf eq2).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
257 .PP
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
258 .PD 0
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
259 .RSs
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
260 .IPs "1 and 2"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
261 adjust contrast
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
262 .IPs "3 and 4"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
263 adjust brightness
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
264 .IPs "5 and 6"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
265 adjust hue
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
266 .IPs "7 and 8"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
267 adjust saturation
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
268 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
269 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
270 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
271 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
272 .B GUI keyboard control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
273 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
274 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
275 .IPs ENTER
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
276 start playing
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
277 .IPs s\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
278 stop playing
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
279 .IPs l\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
280 load file
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
281 .IPs c\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
282 skin browser
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
283 .IPs p\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
284 toggle playlist
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
285 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
286 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
287 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
288 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
289 .B TV input control
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
290 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
291 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
292 .IPs "h and k"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
293 select previous/\:next channel
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
294 .IPs n\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
295 change norm
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
296 .IPs u\ \ \ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
297 change channel list
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
298 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
299 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
300 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
301 .
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
302 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
303 .\" Options
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
304 .\" --------------------------------------------------------------------------
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
305 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
306 .SH "USAGE"
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
307 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
308 \-fs option is \-nofs.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
309 .PP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
310 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
311 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
312 .PP
11942
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
313 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
314 every time MPlayer is run.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
315 The system-wide configuration file 'mplayer.conf' is in your configuration
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
316 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
317 specific one is '~/\:.mplayer/\:config'.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
318 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
319 command line override either.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
320 The syntax of the configuration files is 'option=<value>', everything after
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
321 a '#' is considered a comment.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
322 Options that work without values can be enabled by setting them to 'yes'
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
323 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
324 Even suboptions can be specified in this way.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
325 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
326 .I EXAMPLE:
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
327 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
328 # Use Matrox driver by default.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
329 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
330 vo=xmga
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
331 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
332 # I love practicing handstands while watching videos.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
333 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
334 flip=yes
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
335 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
336 # Decode/\:encode multiple files from png,
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
337 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
338 # start with mf://filemask
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
339 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
340 mf=type=png:fps=25
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
341 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
342 # Eerie negative images are cool.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
343 .br
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
344 vf=eq2=1.0:-0.8
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
345 .PP
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
346 You can also write file-specific configuration files.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
347 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
348 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
349 ~/.mplayer or in the same directory as the file.
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
350 .
5c3e44a8326f Keyboard control section moved to the beginning.
diego
parents: 11941
diff changeset
351 .
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
352 .SH "GENERAL OPTIONS"
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
353 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
354 .B \-codecs-file <filename>
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
355 Use the specified file instead of system wide installed or builtin codecs.conf.
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
356 See also \-afm, \-ac, \-vfm and \-vc.
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
357 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
358 .B \-include <configuration\ file>
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
359 Specify configuration file to be parsed after the default ones.
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
360 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
361 .B \-quiet \ \
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
362 Make console output less verbose; in particular, prevents the status line
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
363 (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
364 Particularly useful on slow terminals or broken ones which do not properly
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
365 handle carriage return (i.e.\& \\r).
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
366 .TP
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
367 .B \-v, \-verbose
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
368 Increment verbose level (more \-v means more verbosity).
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
369 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
370 .PD 0
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
371 .RSs
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
372 .IPs 0
11949
86da102d74d8 slight wording improvement, noticed by Dominik
diego
parents: 11943
diff changeset
373 only some informational output (default)
11943
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
374 .IPs 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
375 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
376 .IPs 2
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
377 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
378 .IPs 3
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
379 prints everything related to input parsers (parser debug)
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
380 .RE
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
381 .PD 1
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
382 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
383 .
c504f20feaac GENERAL OPTIONS section added with a few entries, misc changes.
diego
parents: 11942
diff changeset
384 .
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
385 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
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
386 .TP
11448
gabucino
parents: 11446
diff changeset
387 .B \-autoq <quality> (use with \-vf [s]pp)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
388 Dynamically changes the level of postprocessing depending on the available spare
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
389 CPU time.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
390 The number you specify will be the maximum level used.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
391 Usually you can use some big number.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
392 You have to use \-vf [s]pp without parameters in order for this to work.
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
393 .TP
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
394 .B \-autosync <factor>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
395 Gradually adjusts the A/\:V sync based on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
396 Specifying \-autosync\ 0, the default, will cause frame timing to be based
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
397 entirely on audio delay measurements.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
398 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
399 correction algorithm.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
400 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
401 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
402 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
403 Try \-autosync\ 30 to smooth out problems with sound drivers which do
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
404 not implement a perfect audio delay measurement.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
405 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
406 1 or 2\ seconds to settle out.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
407 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
408 side-effect of turning this option on, for all sound drivers.
7576
c135f7646036 new opt: -autosync, controls ao->get_delay() smoothing (default: disabled)
arpi
parents: 7488
diff changeset
409 .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
410 .B \-benchmark
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
411 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
412 Use in combination with \-nosound and \-vo null for benchmarking only the
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
413 video codec.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
414 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
415 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
416 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
417 only video (you can think of that as infinite fps).
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
418 .TP
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
419 .B \-colorkey <number>
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
420 Changes the colorkey to an RGB value of your choice.
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
421 0x000000 is black and 0xffffff is white.
11224
00e639844c85 colorkeying fixes
alex
parents: 11203
diff changeset
422 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
00e639844c85 colorkeying fixes
alex
parents: 11203
diff changeset
423 xover video out drivers.
11131
8b2d7d006bdd -colorkey documented.
diego
parents: 11126
diff changeset
424 .TP
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
425 .B \-nocolorkey
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
426 Disables colorkeying.
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
427 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
428 xover video out drivers.
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
429 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
430 .B \-edl <filename> (EDL only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
431 Enables edit decision list (EDL) actions during playback.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
432 Video will be skipped over and audio will be muted and unmuted according to
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
433 the entries in the given file.
11185
ee8da27cade7 more docs path fixes
diego
parents: 11181
diff changeset
434 See DOCS/HTML/en/edl.html for details on how to use this.
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
435 .TP
12461
4862a4cdd3b0 Mark EDL only options as such, typo.
diego
parents: 12427
diff changeset
436 .B \-edlout <filename> (EDL only)
8552
37dd9f68ab71 - and -use-stdin documented, EDL updates.
diego
parents: 8541
diff changeset
437 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
438 During playback, when the user hits 'i', an entry to skip over the last two
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
439 seconds of playback will be written to the file.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
440 This provides a starting point from which the user can fine-tune EDL entries
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
441 later.
11185
ee8da27cade7 more docs path fixes
diego
parents: 11181
diff changeset
442 See DOCS/HTML/en/edl.html for details.
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
443 .TP
9309
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
444 .B \-enqueue (GUI only)
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
445 Enqueue files given on the command line in the playlist instead of playing them
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
446 immediately.
073127ce3644 -enqueue documented.
diego
parents: 9282
diff changeset
447 .TP
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
448 .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
449 Enforces a fixed video system for multiple files (one (un)initialisation for
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
450 all files).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
451 Therefore only one window will be opened for all files.
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
452 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
453 xmga, xv, xvidix and dfbmga.
8531
1aa2c9b460af Merged EDL 0.5 patch - it's something like Quicktime's edit lists.
arpi
parents: 8517
diff changeset
454 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
455 .B \-framedrop (also see \-hardframedrop)
9269
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
456 Skip displaying some frames to maintain A/\:V sync on slow systems.
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
457 Video filters are not applied to such frames.
e20e3c0cd9da -framedrop clarified as explained by Rich.
diego
parents: 9258
diff changeset
458 For B frames even decoding is skipped completely.
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
459 .TP
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
460 .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
461 Show short summary of options.
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
462 .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
463 .B \-hardframedrop
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
464 More intense frame dropping (breaks decoding).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
465 Leads to image distortion!
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
466 .TP
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
467 .B \-identify
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
468 Show file parameters in an easily parseable format.
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
469 The wrapper script TOOLS/midentify suppresses the other MPlayer output and
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
470 (hopefully) shellescapes the filenames.
7864
dacc35bc92c7 add -identify switch
ranma
parents: 7814
diff changeset
471 .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
472 .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
473 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
474 Paths are relative to ~/\:.mplayer/.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
475 .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
476 .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
477 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
478 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
479 Available commands are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
480 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
481 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
482 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
483 .IPs conf=<file>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
484 Read alternative input.conf.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
485 If no full path is given, ~/\:.mplayer/<file> is assumed.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
486 .IPs ar-delay
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
487 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
488 .IPs ar-rate
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
489 Number of key presses to generate per second on autorepeat.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
490 .IPs keylist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
491 Prints all keys that can be bound to commands.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
492 .IPs cmdlist
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
493 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
494 .IPs js-dev
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
495 Specifies the joystick device to use (default is /dev/\:input/\:js0).
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
496 .IPs file\
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
497 Read commands from the given file.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
498 Mostly useful with a fifo.
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
499 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
500 .I NOTE:
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
501 When the given file is a fifo MPlayer opens both ends so you can do
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
502 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
503 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
504 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
505 .
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
506 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
507 .B \-lircconf <file> (LIRC only)
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
508 Specifies a configuration file for LIRC (default: ~/\:.lircrc).
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
10784
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
510 .B \-list-options
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
511 Prints out all the available options.
7e91fbf67406 fixes and documented -list-options
alex
parents: 10782
diff changeset
512 .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
513 .B \-loop <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
514 Loops movie playback <number> times.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
515 0 means forever.
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
516 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
517 .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
518 Turn on OSD menu support.
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
519 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
520 .B \-menu-cfg <file> (OSD menu only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
521 Use an alternative menu.conf.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
522 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
523 .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
524 Specify the main menu.
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
525 .TP
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
526 .B \-noconsolecontrols
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
527 Prevent MPlayer from reading key events from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
528 Useful when reading data from standard input.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
529 This is automatically enabled when \- is found on the command line.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
530 There are situations where you have to set it manually, e.g.\&
12816
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
531 if you open /dev/stdin (or the equivalent on your system), use stdin
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
532 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
533 loadlist slave commands.
fba780800efe -use-stdin renamed to -noconsolecontrols.
diego
parents: 12813
diff changeset
534 .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
535 .B \-nojoystick
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
536 Turns off joystick support.
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
537 .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
538 .B \-nolirc
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
539 Turns off LIRC support.
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
540 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
541 .B \-nomouseinput (X11 only)
10770
diego
parents: 10769
diff changeset
542 Disable mouse button press/release input (mozplayerxp's context menu relies
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
543 on this option).
10761
040c2011aace fixing alphabetic order
gabucino
parents: 10760
diff changeset
544 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
545 .B \-nortc (RTC only)
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
546 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
547 mechanism.
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
548 .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
549 .B \-playlist <file>
12767
f60b9fac3146 better wording/spelling as suggested by the wanderer
diego
parents: 12748
diff changeset
550 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
551 one-file-per-line format).
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
552 .br
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
553 .I NOTE:
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
554 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
555 only to the elements of this playlist.
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
556 .br
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
557 FIXME: This needs to be clarified and documented thoroughly.
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
558 .TP
12715
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
559 .B \-really-quiet (also see \-quiet)
e274b6133b2e better -really-quiet description
diego
parents: 12712
diff changeset
560 Display even less output and status messages than with \-quiet.
8234
ebf9a61bb88c -really-quiet documented
diego
parents: 8221
diff changeset
561 .TP
12712
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
562 .B \-rtc-device <device>
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
563 Use the specified device for RTC timing.
365b59f70061 -rtc-device
diego
parents: 12697
diff changeset
564 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
565 .B \-shuffle
8452
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
566 Play files in random order.
418b0017a8d2 -rnd --> -shuffle
diego
parents: 8435
diff changeset
567 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
568 .B \-skin <name> (GUI only)
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
569 Loads a skin from the directory given as parameter below the default skin
12732
6b8ca35d8e3d incomplete skin directories, noticed by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12731
diff changeset
570 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
571 .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
572 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
573 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
574 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
575 .IPs "\-skin fittyfene"
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
576 Tries /usr/local/share/mplayer/Skin/fittyfene
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
577 and afterwards ~/.mplayer/Skin/fittyfene.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
578 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
579 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
580 .
7284
a6dc13dd2fd0 cosmetics: notes, examples, synopsis, preparations for rewrite, removed spaces at end, moved player options at beginning and decoding before encoding options, some small changes, no content changes
jonas
parents: 7259
diff changeset
581 .TP
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
582 .B \-slave (also see \-input)
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
583 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
584 Instead of intercepting keyboard events, MPlayer will read commands from stdin.
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
585 See DOCS/tech/slave.txt and \-input cmdlist for a list of slave commands.
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
586 .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
587 .B \-softsleep
12621
18ffdba9bda5 wording/spelling improvements as suggested by the Wanderer
diego
parents: 12620
diff changeset
588 Use high-quality software timers instead of the RTC.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
589 As precise as the RTC without requiring special privileges.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
590 Comes at the price of higher CPU consumption.
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
591 .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
592 .B \-speed <0.01\-100>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
593 Slow down or speed up playback by the factor given as parameter.
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
594 .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
595 .B \-sstep <sec>
12620
87a640a957fa wording, spelling, bug fixes
diego
parents: 12615
diff changeset
596 Display one frame every <sec> seconds.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
597 Useful for slideshows.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
598 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
599 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
600 .SH "DEMUXER/STREAM OPTIONS"
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
601 .TP
12285
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
602 .B \-a52drc <level>
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
603 Select the Dynamic Range Compression level for AC3 audio streams.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
604 <level> is a float value ranging from 0 to 1, where 0 means no compression
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
605 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
606 silent and vice versa).
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
607 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
608 compression information.
67b8d64af8c7 a52 dynamic range compression support by Peter Gansterer
alex
parents: 12282
diff changeset
609 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
610 .B \-aid <id> (also see \-alang)
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
611 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
612 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
613 MPlayer prints the available IDs when run in verbose (\-v) mode.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
614 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
615 (if present) with the chosen audio stream.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
616 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
617 .B \-alang <two letter\ country\ code> (also see \-aid) (DVD only)
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
618 Selects the DVD audio language and tries to play audio streams whose
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
619 language matches the given code.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
620 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
621 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
622 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
623 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
624 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
625 .IPs "\-alang hu,en"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
626 Plays Hungarian and falls back to English if Hungarian is not available.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
627 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
628 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
629 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
630 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
631 .B \-audio-demuxer <number> (\-audiofile only)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
632 Force audio demuxer type for \-audiofile.
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
633 Give the demuxer ID as defined in libmpdemux/demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
634 \-audio-demuxer 17 forces MP3.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
635 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
636 .B \-audiofile <filename>
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
637 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
638 movie.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
639 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
640 .B \-audiofile-cache <kBytes>
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
641 Enables caching for the stream used by \-audiofile, using the specified
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
642 amount of memory.
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
643 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
644 .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
645 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
646 able to send content in different bitrates).
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
647 Useful if you want to watch live streamed media behind a slow connection.
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
648 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
649 .B \-cdrom-device <path\ to\ device>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
650 Specify the CD-ROM device (default: /dev/\:cdrom).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
651 .TP
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
652 .B \-cache <kBytes>
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
653 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
654 file or URL.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
655 Especially useful on slow media.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
656 .TP
12933
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
657 .B \-cache-min <percentage>
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
658 Playback will start when the cache fill threshold set with this option
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
659 is reached.
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
660 .TP
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
661 .B \-cache-prefill <percentage> (not yet implemented)
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
662 When the cache is emptied MPlayer will pause and restart playback when
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
663 the cache prefill threshold set with this option is reached.
408b1fe2c4e1 -cache-min, -cache-prefill documented.
diego
parents: 12919
diff changeset
664 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
665 .B \-cdda <option1:option2> (CDDA only)
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
666 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
667 .sp 1
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
668 Available options are:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
669 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
670 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
671 .IPs speed=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
672 Set CD spin speed.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
673 .IPs paranoia=<0\-2>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
674 Set paranoia level.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
675 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
676 0: disable checking
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
677 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
678 1: overlap checking only (default)
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
679 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
680 2: full data correction and verification
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
681 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
682 .IPs generic-dev=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
683 Use specified generic SCSI device.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
684 .IPs sector-size=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
685 Set atomic read size.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
686 .IPs overlap=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
687 Force minimum overlap search during verification to <value> sectors.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
688 .IPs toc-bias
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
689 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
690 addressed as LBA\ 0.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
691 Some Toshiba drives need this for getting track boundaries correct.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
692 .IPs toc-offset=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
693 Add <value> sectors to the values reported when addressing tracks.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
694 May be negative.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
695 .IPs (no)skip
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
696 (Never) accept imperfect data reconstruction.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
697 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
698 .
6389
6cc6d0365416 added cdda (paranoia) dox
gabucino
parents: 6383
diff changeset
699 .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
700 .B \-channels <number>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
701 Change the number of playback channels (default: 2).
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
702 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
703 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
704 channel is repeated in both output channels).
15fa4667cddf -channels description expanded, patch by gabor <gabor@realtime.sk>.
diego
parents: 8140
diff changeset
705 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
706 results depend on the audio decoder (\-afm).
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
707 MPlayer asks the decoder to decode the audio into as many channels as
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
708 specified.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
709 Now it's up to the decoder to fulfill the requirement.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
710 If the decoder outputs more channels than requested, the exceeding channels
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
711 are truncated.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
712 This is usually only important when playing videos with AC3 audio (like DVDs).
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
713 In that case liba52 does the decoding by default and correctly downmixes the
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
714 audio into the requested number of channels.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
715 .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
716 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
717 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
718 (OSS at least).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
719 .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
720 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
721 .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
722 .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
723 .RSs
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
724 .IPs 2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
725 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
726 .IPs 4
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
727 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
728 .IPs 6
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
729 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
730 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
731 .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
732 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
733 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
734 .B \-chapter <chapter\ id>[\-<end\ chapter\ id>] (DVD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
735 Specify which chapter to start playing at.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
736 Optionally specify which chapter to end playing at (default: 1).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
737 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
738 .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
739 Send cookies when making HTTP requests.
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
740 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
741 .B \-cookies-file <filename> (network only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
742 Read HTTP cookies from specified file (default: ~/.mozilla/ and ~/.netscape/)
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
743 and skip reading from default locations.
11603
fbef9326c2ed small fixes
diego
parents: 11600
diff changeset
744 The file is assumed to be in Netscape format.
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
745 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
746 .B \-demuxer <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
747 Force demuxer type.
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
748 Give the demuxer ID as defined in libmpdemux/demuxer.h.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
749 \-demuxer 17 forces MP3.
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
750 .TP
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
751 .B \-dumpaudio (MPlayer only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
752 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC3).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
753 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
754 .B \-dumpfile <filename> (MPlayer only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
755 Specify which file MPlayer should dump to.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
756 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
757 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
758 .B \-dumpstream (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
759 Dumps the raw stream to ./stream.dump.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
760 Useful when ripping from DVD or network.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
761 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
762 .B \-dumpvideo (MPlayer only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
763 Dump raw compressed video stream to ./stream.dump (not very usable).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
764 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
765 .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
766 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
767 the default ones:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
768 .sp 1
10615
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
769 .PD 0
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
770 .RSs
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
771 .IPs card=<1\-4>
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
772 Specifies using card number 1\-4 (default: 1).
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
773 .IPs file=<file>
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
774 Instructs MPlayer to read the channels list from <file>.
12187
441803819454 DVB update, patch by Nico <nsabbi@tiscali.it>
diego
parents: 12081
diff changeset
775 Default is ~/.mplayer/channels.conf.{sat,ter,cbl} (based on your card type)
441803819454 DVB update, patch by Nico <nsabbi@tiscali.it>
diego
parents: 12081
diff changeset
776 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
777 .RE
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
778 .PD 1
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
779 .
65226e2ea605 DVB input documentation by Nico <nsabbi@libero.it> with some changes by me.
diego
parents: 10571
diff changeset
780 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
781 .B \-dvd-device <path\ to\ device> (DVD only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
782 Specify the DVD device (default: /dev/\:dvd).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
783 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
784 .B \-dvdangle <angle\ id> (DVD only)
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
785 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
786 Here you can tell MPlayer which angles to use (default: 1).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
787 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
788 .B \-forceidx
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
789 Force index rebuilding.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
790 Useful for files with broken index (A/V desync, etc).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
791 This will enable seeking in files where seeking was not possible.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
792 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
793 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
794 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
795 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
796 (i.e.\& not with stdin, pipe, etc).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
797 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
798 .B \-fps <float value>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
799 Override video framerate.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
800 Useful if the original value is wrong or missing.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
801 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
802 .B \-frames <number>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
803 Play/\:convert only first <number> frames, then quit.
472
a25ba0fd865e commiting yesterday's changes that accidently lost ;(((
gabucino
parents: 454
diff changeset
804 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
805 .B \-hr-mp3-seek (MP3 only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
806 Hi-res MP3 seeking.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
807 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
808 to the very exact position to keep A/\:V sync.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
809 Can be slow especially when seeking backwards since it has to rewind
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
810 to the beginning to find an exact frame position.
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
811 .TP
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
812 .B \-idx (also see \-forceidx)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
813 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
814 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
815 .br
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
816 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
817 This option only works if the underlying media supports seeking
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
818 (i.e.\& not with stdin, pipe, etc).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
819 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
820 .B \-ipv4-only-proxy (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
821 Skip the proxy for IPv6 addresses.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
822 It will still be used for IPv4 connections.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
823 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
824 .B \-loadidx <index file>
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
825 The file from which to read the video index data saved by \-saveidx.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
826 This index will be used for seeking, overriding any index data
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
827 contained in the AVI itself.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
828 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
829 from a different AVI, but this is sure to cause unfavorable results.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
830 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
831 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
832 This option is obsolete now that MPlayer has OpenDML support.
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
833 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
834 .B \-mc <seconds/frame>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
835 maximum A-V sync correction per frame (in seconds)
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
836 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
837 .B \-mf <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
838 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
839 .sp 1
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
840 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
841 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
842 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
843 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
844 .IPs w=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
845 output width (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
846 .IPs h=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
847 output height (default: autodetect)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
848 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
849 output fps (default: 25)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
850 .IPs type=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
851 input file type (available: jpeg, png, tga, sgi)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
852 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
853 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
854 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
855 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
856 .B \-ni (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
857 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
858 of some bad AVI files).
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
859 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
860 .B \-nobps (AVI only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
861 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
862 Helps with some AVI files with broken header.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
863 .TP
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
864 .B \-noextbased
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
865 Disables extension-based demuxer selection.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
866 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
867 (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
868 extension is used to select the demuxer.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
869 Always falls back to content-based demuxer selection.
9006
d00997f12257 extension-based filetype detection for headerless files (mp3 vs mpeg, etc)
arpi
parents: 8960
diff changeset
870 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
871 .B \-passwd <password> (see \-user option too) (network only)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
872 Specify password for HTTP authentication.
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
873 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
874 .B \-prefer-ipv4 (network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
875 Use IPv4 on network connections.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
876 Falls back to IPv6 automatically.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
877 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
878 .B \-prefer-ipv6 (IPv6 network only)
10327
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
879 Use IPv6 on network connections.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
880 Falls back to IPv4 automatically.
fd2ba6640689 Document -ipv4-only-proxy and -prefer-ip4/6.
diego
parents: 10304
diff changeset
881 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
882 .B \-rawaudio <option1:option2:...>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
883 This option lets you play raw audio files.
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
884 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
885 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
886 .sp 1
6753
4e5294c0dafb Huge patch by Jonas Jermann <jjermann@gmx.net> (2/2).
diego
parents: 6752
diff changeset
887 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
888 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
889 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
890 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
891 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
892 Use raw audio demuxer.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
893 .IPs channels=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
894 number of channels
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
895 .IPs rate=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
896 rate in samples per second
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
897 .IPs samplesize=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
898 sample size in bytes
12282
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
899 .IPs bitrate=<value>
76dc8fd54dec rawaudio bitrate option
diego
parents: 12252
diff changeset
900 bitrate for rawaudio files
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
901 .IPs format=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
902 fourcc in hex
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
903 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
904 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
905 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
906 .TP
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
907 .B \-rawvideo <option1:option2:...>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
908 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
909 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
910 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
911 .sp 1
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
912 .PD 0
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
913 .RSs
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
914 .IPs on\ \ \
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
915 Use raw video demuxer.
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
916 .IPs fps=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
917 rate in frames per second (default: 25.0)
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
918 .IPs sqcif|qcif|cif|4cif|pal|ntsc
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
919 set standard image size
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
920 .IPs w=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
921 image width in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
922 .IPs h=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
923 image height in pixels
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
924 .IPs y420|yv12|yuy2|y8
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
925 set colorspace
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
926 .IPs format=<value>
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
927 colorspace (fourcc) in hex
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
928 .IPs size=<value>
9716
72f795ef6bf3 -audiofile-cache documented, bytes --> Bytes, typo.
diego
parents: 9704
diff changeset
929 frame size in Bytes
9065
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
930 .RE
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
931 .PD 1
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
diff changeset
932 .
59805b2d220a raw video demuxer, requested by Michael
arpi
parents: 9063
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 \-rtsp-stream-over-tcp (live.com only)
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
935 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
936 packets be streamed over TCP (using the same TCP connection as RTSP).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
937 This option may be useful if you have a broken internet connection that does
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
938 not pass incoming UDP packets (see http://www.live.com/mplayer/).
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
939 .TP
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
940 .B \-saveidx <filename>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
941 Force index rebuilding and dump the index to <filename>.
11293
e9f585aec12e -loadidx and -saveidx explanation extended.
diego
parents: 11286
diff changeset
942 Currently this only works with AVI files.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
943 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
944 .I NOTE:
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
945 This option is obsolete now that MPlayer has OpenDML support.
11247
88e25438004b loadidx and saveidx options based on Jasons patch
alex
parents: 11237
diff changeset
946 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
947 .B \-sb <byte\ position> (see \-ss option too)
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
948 Seek to byte position.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
949 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
950 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
951 .B \-srate <Hz>
11906
47e9cd92d163 Fix description of -srate, as pointed out by Rich.
diego
parents: 11904
diff changeset
952 Selects the given output sampling rate, resampling if necessary.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
953 MEncoder passes this value to LAME for resampling.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
954 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
955 .B \-ss <time> (see \-sb option too)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
956 Seek to given time position.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
957 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
958 .I EXAMPLE:
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 "\-ss 56"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
962 Seeks to 56 seconds.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
963 .IPs "\-ss 01:10:00"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
964 Seeks to 1\ hour 10\ min.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
965 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
966 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
967 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
968 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
969 .B \-tskeepbroken
11203
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
970 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
971 Sometimes needed to play corrupted MPEG-TS files.
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
972 .
f998a3b572ab -tskeepbroken and -tsprog descriptions by Nico <nsabbi@libero.it>
diego
parents: 11197
diff changeset
973 .TP
12994
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
974 .B \-tsprobe <byte\ position>
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
975 When playing an MPEG-TS stream, this option lets you specify how many
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
976 bytes in the stream you want MPlayer to search for the desired
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
977 audio and video pids.
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
978 .
b67e0c65a9c5 alphabetical order
diego
parents: 12991
diff changeset
979 .TP
10688
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
980 .B \-tsprog <1\-65534>
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
981 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
982 program (if present) you want to play.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
983 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
984 .
c2331e3ef96a - re-added the old and (no more used) option -tsfastparse with a
arpi
parents: 10671
diff changeset
985 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
986 .B \-tv <option1:option2:...> (TV only)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
987 This option tunes various properties of the TV capture module.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
988 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
989 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
990 as a movie URL.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
991 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
992 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
993 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
994 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
995 .IPs noaudio
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
996 no sound
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
997 .IPs driver=<value>
10537
31f12f99118b v4l2 support
henry
parents: 10524
diff changeset
998 available: dummy, v4l, v4l2, bsdbt848
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
999 .IPs device=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1000 Specify TV device (default: /dev/\:video0).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1001 .IPs input=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1002 Specify input (default: 0 (TV), see console output for available inputs).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1003 .IPs freq=<value>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1004 Specify the frequency to set the tuner to (e.g.\& 511.250).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1005 Not compatible with the channels parameter.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1006 .IPs outfmt=<value>
11365
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1007 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
1008 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
1009 arbitrary format given as hex value.
23cb5b69113d Document TV outfmt arbitrary formats and outfmt=help.
diego
parents: 11333
diff changeset
1010 Try outfmt=help for a list of all available formats.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1011 .IPs width=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1012 output window width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1013 .IPs height=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1014 output window height
8879
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1015 .IPs fps=<value>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1016 framerate at which to capture video (frames per second)
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1017 .IPs buffersize=<value>
9282
513e02e2e553 fixing others' 10/100liters
gabucino
parents: 9269
diff changeset
1018 maximum size of the capture buffer in megabytes (default: dynamical)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1019 .IPs norm=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1020 available: PAL, SECAM, NTSC.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1021 For v4l2 use the normid option below.
13016
61d0fd8411cc Missing quotes added
wight
parents: 13014
diff changeset
1022 .IPs "normid=<value> (v4l2 only)"
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1023 See console output for a list of available TV norms.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1024 .IPs channel=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1025 Set tuner to <value> channel.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1026 .IPs chanlist=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1027 available: europe-east, europe-west, us-bcast, us-cable, etc
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
1028 .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
1029 Set names for channels.
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1030 Use _ for spaces in names (or play with quoting ;-).
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1031 The channel names will then be written using OSD, and the slave commands
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1032 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
1033 a remote control (see LIRC).
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1034 Not compatible with the frequency parameter.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1035 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1036 .I NOTE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1037 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
1038 beginning with 1.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1039 .br
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1040 .I EXAMPLE:
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1041 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
1042 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1043 Set the image equalizer on the card.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1044 .IPs audiorate=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1045 Set audio capture bitrate.
7907
4979eeaf0564 v4l options update
henry
parents: 7882
diff changeset
1046 .IPs forceaudio
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1047 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
1048 .IPs alsa\
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1049 Capture from ALSA.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1050 .IPs amode=<0\-3>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1051 Choose an audio mode:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1052 .RSss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1053 0: mono
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1054 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1055 1: stereo
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1056 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1057 2: language 1
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
1058 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1059 3: language 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1060 .REss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1061 .IPs forcechan=<1\-2>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1062 By default, the count of recorded audio channels is determined automatically
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1063 by querying the audio mode from the TV card.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1064 This option allows forcing stereo/\:mono recording regardless of the amode
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1065 option and the values returned by v4l.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1066 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
1067 current audio mode.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1068 .IPs adevice=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1069 Set an audio device.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1070 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1071 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
1072 .IPs audioid=<value>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1073 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
1074 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1075 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1076 These options set parameters of the mixer on the video capture card.
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1077 They will have no effect, if your card does not have one.
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1078 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
1079 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
1080 .IPs immediatemode=<bool>
1a3a118bbd56 document Arpi's #2,3,7 (fps, immediatemode, eq2). #6,9,10,11 still
rfelker
parents: 8875
diff changeset
1081 A value of 0 means capture and buffer audio and video together
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1082 (default for MEncoder).
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
1083 A value of 1 (default for MPlayer) means to do video capture only and let the
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1084 audio go through a loopback cable from the TV card to the soundcard.
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1085 .IPs mjpeg
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1086 Use hardware MJPEG compression (if the card supports it).
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1087 When using this option, you do not need to specify the width and height
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1088 of the output window, because MPlayer will determine it automatically
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1089 from the decimation value (see below).
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1090 .IPs decimation=<1,2,4>
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1091 choose the size of the picture that will be compressed by hardware
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1092 MJPEG compression:
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1093 .RSss
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1094 1: full size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1095 704x576 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1096 704x480 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1097 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1098 2: medium size
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1099 352x288 PAL
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1100 352x240 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1101 .br
9681
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1102 4: small size
3d4490296f2f Man page synchronized with vop.txt plus further clarifications and
diego
parents: 9664
diff changeset
1103 176x144 PAL
9620
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1104 176x120 NTSC
ce4cd85498f3 hardware mjpeg encoding using v4l by Iv«¡n Sz«¡nt«Ñ <szivan@freemail.hu>
henry
parents: 9554
diff changeset
1105 .REss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1106 .IPs quality=<0\-100>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1107 Choose the quality of the JPEG compression
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1108 (< 60 recommended for full size).
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1109 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1110 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1111 .TP
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1112 .B \-user <user name> (also see \-passwd) (network only)
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1113 Specify user name for HTTP authentication.
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
1114 .TP
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1115 .B \-user-agent <string>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1116 Use <string> as user agent for HTTP streaming.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
1117 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1118 .B \-vid <id>
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1119 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
12862
01e2dd55bf49 embarassing typo
diego
parents: 12855
diff changeset
1120 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
1121 (if present) with the chosen video stream.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1122 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1123 .B \-vivo <sub-options> (DEBUG CODE)
12990
53ccf64d19b2 man page review part II
diego
parents: 12989
diff changeset
1124 Force audio parameters for the VIVO demuxer (for debugging purposes).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1125 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1126 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1127 .SH "OSD/SUB OPTIONS"
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1128 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1129 Also see \-vf expand.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1130 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1131 .B \-dumpjacosub (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1132 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1133 JACOsub subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1134 Creates a dumpsub.js file in the current directory.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1135 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1136 .B \-dumpmicrodvdsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1137 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
1138 MicroDVD subtitle format.
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1139 Creates a dumpsub.sub file in the current directory.
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1140 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1141 .B \-dumpmpsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1142 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
1143 subtitle format, MPsub.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1144 Creates a dump.mpsub file in the current directory.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1145 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1146 .B \-dumpsami (MPlayer only)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1147 Convert the given subtitle (specified with the \-sub option) to the time-based
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1148 SAMI subtitle format.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1149 Creates a dumpsub.smi file in the current directory.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1150 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1151 .B \-dumpsrtsub (MPlayer only)
9139
248095a9041d changing "switch" -> "option" (unwritten DOCS rule)
gabucino
parents: 9126
diff changeset
1152 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
1153 SubViewer (SRT) subtitle format.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1154 Creates a dumpsub.srt file in the current directory.
6378
64a828f1872b added -dumpsrtsub
gabucino
parents: 6351
diff changeset
1155 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1156 .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
1157 Dumps the subtitle substream from VOB streams.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1158 Also see the \-dump*sub and \-vobsubout* options.
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
1159 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1160 .B \-ffactor <number> (OSD only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1161 Resample the font alphamap.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1162 Can be:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1163 .
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1164 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1165 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1166 .IPs 0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1167 plain white fonts
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1168 .IPs 0.75
8762
75d22ee5f975 Per-file configuration, typos, rewordings, consistency and a 10l .In.
diego
parents: 8745
diff changeset
1169 very narrow black outline (default)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1170 .IPs 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1171 narrow black outline
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1172 .IPs 10
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1173 bold black outline
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1174 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1175 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1176 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1177 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1178 .B \-flip-hebrew (FriBiDi only)
10670
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1179 Turns on flipping subtitles using FriBiDi.
7757aee67551 no need to document -flip_hebrew and -noflip_hebrew, alphabetical order.
diego
parents: 10667
diff changeset
1180 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1181 .B \-font <path\ to\ font.desc\ file> (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1182 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
1183 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1184 ~/.mplayer/\:subfont.ttf).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1185 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1186 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1187 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
1188 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
1189 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1190 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1191 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1192 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1193 \-font ~/\:.mplayer/\:arial-14/\:font.desc
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1194 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1195 \-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
1196 .br
90953d955165 Fontconfig support based on patch by Arwed von Merkatz <v.merkatz@gmx.net>, but slightly reworked
alex
parents: 11572
diff changeset
1197 \-font 'Bitstream Vera Sans'
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1198 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1199 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1200 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1201 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1202 .B \-fontconfig (fontconfig only)
11708
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1203 Enables the usage of fontconfig managed fonts.
ce988d24582c -fontconfig option
diego
parents: 11702
diff changeset
1204 .TP
10917
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1205 .B \-forcedsubsonly
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1206 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
1207 \-slang.
d45870f67728 Forced subtitles patch by Arne Driescher <driescher@mpi-magdeburg.mpg.de>
attila
parents: 10906
diff changeset
1208 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1209 .B \-fribidi-charset <charset\ name> (FriBiDi only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1210 Specifies the character set that will be passed to FriBiDi when
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1211 decoding non-UTF-8 subtitles (default: ISO8859-8).
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1212 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1213 .B \-ifo <VOBsub\ ifo\ file>
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1214 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
1215 subtitles.
10667
38b2ff65fc42 FriBiDi control flags
gabucino
parents: 10665
diff changeset
1216 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1217 .B \-noautosub
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1218 Turns off automatic subtitle file loading.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1219 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
1220 .B \-osdlevel <0\-3> (MPlayer only)
8810
bdcde34deb14 10l, osdlevel, fixes
jonas
parents: 8806
diff changeset
1221 Specifies which mode the OSD should start in.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1222 .
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1223 .PD 0
8811
jonas
parents: 8810
diff changeset
1224 .RSs
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1225 .IPs 0
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1226 subtitles only
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1227 .IPs 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1228 volume + seek (default)
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1229 .IPs 2
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1230 volume + seek + timer + percentage
9162
jonas
parents: 9139
diff changeset
1231 .IPs 3
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1232 volume + seek + timer + percentage + total time
8811
jonas
parents: 8810
diff changeset
1233 .RE
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1234 .PD 1
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1235 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1236 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1237 .B \-overlapsub
10393
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1238 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
1239 still visible (default is to enable the support only for specific
122564a2df38 -overlapsub clarified (thanks, Rich), -nooverlapsub removed (redundant)
diego
parents: 10387
diff changeset
1240 formats).
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1241 .TP
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1242 .B \-sid <ID> (also see \-slang option)
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1243 Display DVD subtitles in the language specified by <ID> (0\-31).
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1244 MPlayer prints the available subtitle languages when run in verbose (\-v) mode.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1245 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1246 .B \-slang <two\ letter\ country\ code> (also see \-sid option)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1247 Selects DVD subtitle language.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1248 MPlayer prints the available subtitle languages when run in verbose (\-v) mode.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1249 .br
9870
09d630a4f991 support for multiple subtitle files by Marcin Wojdyr <wojdyr@unipress.waw.pl>
henry
parents: 9866
diff changeset
1250 Otherwise, determines an optional subtitle suffix which gets a higher
09d630a4f991 support for multiple subtitle files by Marcin Wojdyr <wojdyr@unipress.waw.pl>
henry
parents: 9866
diff changeset
1251 priority when searching for subtitles.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1252 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1253 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1254 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1255 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1256 .IPs "\-slang hu,en"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1257 Selects Hungarian and falls back to English if Hungarian is not available.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1258 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1259 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1260 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1261 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1262 .B \-spuaa <mode> (OSD only)
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1263 Antialiasing/scaling mode for DVD/VOBsub.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1264 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
1265 when original and scaled frame size already match.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1266 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1267 Available modes are:
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1268 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1269 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1270 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1271 none (fastest, very ugly)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1272 .IPs 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1273 approximate (broken?)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1274 .IPs 2
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1275 full (slow)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1276 .IPs 3
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1277 bilinear (default, fast and not too bad)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1278 .IPs 4
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1279 uses swscaler gaussian blur (looks very good)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1280 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1281 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1282 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1283 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1284 .B \-spualign <-1\-2> (OSD only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1285 Specify how SPU (DVD/VOBsub) subtitles should be aligned.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1286 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1287 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1288 .IPs -1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1289 original position
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1290 .IPs 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1291 align at top (original/default behavior)
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1292 .IPs 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1293 align at center
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1294 .IPs 2
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1295 align at bottom
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1296 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1297 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1298 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1299 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1300 .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
1301 Variance parameter of gaussian used by \-spuaa 4.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1302 Higher means more blur (default: 1.0).
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1303 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1304 .B \-sub <subtitlefile1,subtitlefile2,...>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1305 Use/\:display these subtitle files.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1306 Only one file can be displayed at the same time and the files can be
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1307 switched with 'j'.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1308 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1309 .B \-sub-bg-alpha <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1310 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
1311 Big values mean more transparency.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1312 0 means completely transparent.
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1313 .TP
8617
6ffbe7608013 Me: -sub-bg-* would be nicer. "Background" is usually shortened as "bg", not "bkg".
rathann
parents: 8616
diff changeset
1314 .B \-sub-bg-color <0\-255>
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1315 Specify the color value for subtitles and OSD backgrounds.
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1316 Currently subtitles are grayscale so this value is equivalente to the
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1317 intensity of the color.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1318 255 means white and 0 black.
8601
7fe391d6c293 The following patch adds two new command line options:
arpi
parents: 8583
diff changeset
1319 .TP
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1320 .B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1321 Force subtitle demuxer type for \-subfile.
11095
319337469b9b -sub-demuxer description extended.
diego
parents: 11094
diff changeset
1322 Give the demuxer ID as defined in subreader.h.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1323 .TP
11448
gabucino
parents: 11446
diff changeset
1324 .B \-sub-fuzziness <mode>
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1325 Adjust matching fuzziness when searching for subtitles:
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1326 .PD 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1327 .RSs
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1328 .IPs 0
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1329 exact match
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1330 .IPs 1
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1331 Load all subs containing movie name.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1332 .IPs 2
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1333 Load all subs in the current directory.
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1334 .RE
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1335 .PD 1
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1336 .
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1337 .TP
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1338 .B \-sub-no-text-pp
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1339 Disables any kind of text post processing done after loading the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1340 Used for debug purposes.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1341 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1342 .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
1343 Specify how subtitles should be aligned with \-subpos.
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1344 .PD 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1345 .RSs
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1346 .IPs 0
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1347 align at top (original/default behavior)
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1348 .IPs 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1349 align at center
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1350 .IPs 2
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1351 align at bottom
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1352 .RE
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1353 .PD 1
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1354 .
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1355 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1356 .B \-subcc \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1357 Display DVD Closed Caption (CC) subtitles.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1358 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
1359 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
1360 CC subtitles have not been spotted on DVDs from other regions so far.
7049
0caeda287ff9 -subcc option documented, patch by Robert R. Wal <rrw at hell pl>.
diego
parents: 7045
diff changeset
1361 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1362 .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
1363 If your system supports iconv(3), you can use this option to
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1364 specify the subtitle codepage.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1365 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1366 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1367 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1368 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1369 \-subcp latin2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1370 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1371 \-subcp cp1250
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1372 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1373 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1374 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1375 .TP
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1376 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1377 You can specify your language using a two letter language code to
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1378 make ENCA detect the codepage automatically.
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1379 If unsure, enter anything and watch mplayer -v output for available
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1380 languages.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1381 Fallback codepage specifies the codepage to use, when the
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1382 autodetection fails.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1383 .sp 1
12470
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1384 .I EXAMPLE:
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1385 .PD 0
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1386 .RSs
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1387 .IPs "\-subcp enca:cs:latin2"
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1388 Guess the encoding, assuming the subtitles are Czech, fall back to
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1389 latin 2, if the detection fails.
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1390 .IPs "\-subcp enca:pl:cp1250"
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1391 Guess the encoding for Polish, fall back to cp1250.
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1392 .RE
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1393 .PD 1
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1394 .
4ba6c3a67656 ENCA support
henry
parents: 12467
diff changeset
1395 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1396 .B \-subdelay <sec>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1397 Delays subtitles by <sec> seconds.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1398 Can be negative.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1399 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1400 .B \-subfile <filename> (BETA CODE)
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1401 Currently useless.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1402 Same as \-audiofile, but for subtitle streams (OggDS?).
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
1403 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1404 .B \-subfont-autoscale <0\-3> (FreeType only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1405 Sets the autoscale mode.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1406 .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
1407 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1408 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
1409 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1410 The mode can be:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1411 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1412 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1413 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1414 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1415 no autoscale
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1416 .IPs 1
8265
rfelker
parents: 8248
diff changeset
1417 proportional to movie height
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1418 .IPs 2
8265
rfelker
parents: 8248
diff changeset
1419 proportional to movie width
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1420 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1421 proportional to movie diagonal (default)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1422 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1423 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1424 .
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1425 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1426 .B \-subfont-blur <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1427 Sets the font blur radius (default: 2).
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1428 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1429 .B \-subfont-encoding <value> (FreeType only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1430 Sets the font encoding.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1431 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
1432 unicode will be used (default: unicode).
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1433 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1434 .B \-subfont-osd-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1435 Sets the autoscale coefficient of the OSD elements (default: 6).
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1436 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1437 .B \-subfont-outline <0\-8> (FreeType only)
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1438 Sets the font outline thickness (default: 2).
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1439 .TP
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
1440 .B \-subfont-text-scale <0\-100> (FreeType only)
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1441 Sets the subtitle text autoscale coefficient as percentage of the
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1442 screen size (default: 5).
7241
283561e2bef5 better subfont description, moved to the write place
jonas
parents: 7235
diff changeset
1443 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1444 .B \-subfps <rate>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1445 Specify the framerate of the subtitle file (default: movie fps).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1446 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1447 .I NOTE:
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1448 Only for frame-based subtitle files, i.e.\& not MicroDVD format.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1449 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1450 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1451 Specify the position of subtitles on the screen.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1452 The value is the vertical position of the subtitle in % of the screen height.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1453 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1454 .B \-subwidth <10\-100> (OSD only)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1455 Specify the maximum width of subtitles on the screen.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
1456 Useful for TV-out.
8583
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1457 The value is the width of the subtitle in % of the screen width.
4c18c4e7f34e -subwidth
arpi
parents: 8568
diff changeset
1458 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1459 .B \-unicode
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1460 Tells MPlayer to handle the subtitle file as unicode.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1461 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1462 .B \-utf8 \ \
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1463 Tells MPlayer to handle the subtitle file as UTF-8.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1464 .TP
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
1465 .B \-vobsub <VOBsub\ file\ without\ extension>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1466 Specify a VOBsub file to use for subtitles.
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1467 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
1468 the '.idx', '.ifo' or '.sub'.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1469 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1470 .B \-vobsubid <0\-31>
12995
2e2493e9b04b man page review part III
diego
parents: 12994
diff changeset
1471 Specify the VOBsub subtitle ID.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1472 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1473 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1474 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1475 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1476 .B \-abs <value> (OBSOLETE)
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1477 Override audio driver/\:card buffer size detection, \-ao oss only.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1478 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1479 .B \-aofile <filename>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1480 Filename for \-ao pcm.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1481 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
1482 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1483 Specify audio plugin(s) and their options (see documentation too).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1484 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1485 Available options are:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1486 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1487 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1488 .IPs list=[plugins]
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1489 comma separated list of plugins (resample, surround, format, volume,
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1490 extrastereo, volnorm, delay)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1491 .IPs delay=<sec>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1492 example plugin, do not use (delay plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1493 .IPs format=<format>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1494 output format (format plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1495 .IPs fout=<Hz>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1496 output frequency (resample plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1497 .IPs volume=<0\-255>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1498 volume (volume plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1499 .IPs mul=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1500 stereo coefficient (default: 2.5) (extrastereo plugin only)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1501 .IPs softclip
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1502 compressor / 'soft-clipping' capabilities (volume plugin only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1503 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1504 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1505 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1506 .B \-delay <sec>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1507 Audio delay in seconds (may be +/\:- float value).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1508 .TP
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1509 .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
1510 Select the format used for output from the filter layer (according to the
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1511 defines in libao2/afmt.h):
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1512 .
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1513 .PD 0
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1514 .RSs
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1515 .IPs 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1516 Mu-Law
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1517 .IPs 2
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1518 A-Law
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1519 .IPs 4
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1520 Ima-ADPCM
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1521 .IPs 8
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1522 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
1523 .IPs 16
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1524 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
1525 .IPs 32
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1526 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
1527 .IPs 64
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1528 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
1529 .IPs 128
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1530 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
1531 .IPs 256
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1532 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
1533 .IPs 512
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1534 MPEG (2) Audio
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1535 .IPs 1024
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1536 AC3
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1537 .IPs 4096
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1538 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
1539 .IPs 8192
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
1540 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
1541 .RE
8628
eecc9bb4e758 better verbose description, cosmetics
jonas
parents: 8627
diff changeset
1542 .PD 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
1543 .
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1544 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1545 .B \-mixer <device>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1546 This option will tell MPlayer to use a different device for mixing than
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1547 /dev/\:mixer.
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1548 For ALSA this is the mixer name.
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1549 .TP
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1550 .B \-mixer-channel <mixer line> (\-ao oss and \-ao alsa only)
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1551 This option will tell MPlayer to use a different channel for controlling
11840
acef84b653a9 small fixes
diego
parents: 11837
diff changeset
1552 volume than the default PCM.
12748
f11bd27b0ff2 ao_alsa now uses -mixer-channel instead of its special -mixer syntax
reimar
parents: 12743
diff changeset
1553 Options for OSS include
11837
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1554 .B vol, pcm, line.
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1555 For a complete list of options look for SOUND_DEVICE_NAMES in
4e8f8efb6906 add option to select mixer channel
attila
parents: 11816
diff changeset
1556 /usr/include/linux/soundcard.h.
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1557 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
1558 .B Master, Line, PCM.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1559 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1560 .B \-nowaveheader (\-ao pcm only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1561 Don't include wave header.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1562 Used for RAW PCM.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1563 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1564 .
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1565 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1566 Audio output drivers are interfaces to different output facilities.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1567 The syntax is:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1568 .TP
12505
a0b82f1dda7d xvmc and *vidix suboptions documented, better ao/vo suboption syntax
diego
parents: 12479
diff changeset
1569 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1570 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
1571 .PP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1572 If the list has a trailing ',' it will fall back to drivers not listed
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1573 on the command line.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1574 Suboptions are optional and can mostly be omitted.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1575 .br
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1576 .I NOTE:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1577 See \-ao help for a list of compiled-in drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1578 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1579 .I EXAMPLE:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1580 .PD 0
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1581 .RSs
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1582 .IPs "\-ao alsa,oss,"
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1583 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
1584 .IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1585 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
1586 .RE
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1587 .PD 1
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1588 .
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1589 .sp 1
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1590 FIXME: Document suboptions for sdl, arts, esd, jack, nas, macosx, sgi, sun,
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1591 win32, dxr2, mpegpes, null, pcm, plugin.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1592 .sp 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1593 Available audio output drivers are:
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1594 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1595 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1596 .B alsa\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1597 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
1598 .PD 0
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1599 .RSs
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1600 .IPs mmap\ \ \
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1601 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
1602 .IPs noblock
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1603 Sets noblock-mode.
12807
6494aa5947ee ao_alsa now uses the device= suboption syntax instead of hw= or hw:
reimar
parents: 12778
diff changeset
1604 .IPs device=<device>
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1605 Sets the device name.
12919
aba44b58dea7 Use = instead if # in ALSA device name, as # irritates our config-parser.
reimar
parents: 12867
diff changeset
1606 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1607 .RE
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1608 .PD 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1609 .TP
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1610 .B alsa1x (OBSOLETE)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1611 ALSA 1.x audio output driver.
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1612 Obsoleted by the general alsa audio output driver.
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1613 .TP
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1614 .B alsa9 (OBSOLETE)
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1615 ALSA 0.9 audio output driver.
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1616 Obsoleted by the general alsa audio output driver.
12472
87348db65305 -ao option removed, there is a AUDIO OUTPUT DRIVERS section for that now,
diego
parents: 12470
diff changeset
1617 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1618 .B alsa5\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1619 ALSA 0.5 audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1620 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1621 .B oss\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1622 OSS audio output driver
12740
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1623 .PD 0
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1624 .RSs
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1625 .IPs dsp-device
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1626 Sets the audio-output device (default: /dev/dsp).
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1627 .RE
4f84d2eb55b2 ao_alsa and ao_oss documented.
diego
parents: 12732
diff changeset
1628 .PD 1
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1629 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1630 .B sdl\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1631 Highly platform independent SDL (Simple Directmedia Layer) library
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1632 audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1633 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1634 .B arts\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1635 Audio output through the Arts daemon.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1636 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1637 .B esd\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1638 Audio output through the ESD daemon.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1639 .TP
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1640 .B jack\ \ \ \
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1641 Audio output through JACK (Jack Audio Connection Kit).
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12645
diff changeset
1642 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1643 .B nas\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1644 Audio output through NAS.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1645 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1646 .B macosx (Mac OS X only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1647 Native Mac OS X audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1648 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1649 .B sgi (SGI only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1650 Native SGI audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1651 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1652 .B sun (Sun only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1653 Native Sun audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1654 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1655 .B win32 (Windows only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1656 Native Windows waveout audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1657 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
1658 .B dxr2 (also see \-dxr2) (DXR2 only)
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1659 Creative DXR2 specific output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1660 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1661 .B mpegpes (DVB only)
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1662 DVB specific output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1663 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1664 .B null\ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1665 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
1666 Use \-nosound for benchmarking.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1667 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1668 .B pcm\ \ \ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1669 Raw PCM/wave file writer audio output.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1670 Writes the sound to ./audiodump.wav.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1671 .TP
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1672 .B plugin\ \
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1673 Plugin audio output driver.
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1674 .
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
1675 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1676 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1677 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1678 .B \-aa* (\-vo aa only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1679 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
1680 .I mplayer \-aahelp
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1681 .TP
12389
0b1053e9d8da -adapter is not directx specific anymore.
diego
parents: 12388
diff changeset
1682 .B \-adapter <value>
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1683 Set the graphics card that will receive the image.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1684 Needs the \-vm option to work.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1685 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
1686 Works currently only with \-vo directx.
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1687 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1688 .B \-bpp <depth>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1689 Use different color depth than autodetect.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1690 Not all \-vo drivers support it (fbdev, dga2, svga, vesa).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1691 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1692 .B \-brightness <-100\-100>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1693 Adjust brightness of video output (default 0).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1694 It changes intensity of RGB components of video signal from black to white
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1695 screen.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1696 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1697 .B \-contrast <-100\-100>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1698 Adjust contrast of video output (default 0).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1699 Works in similar manner as brightness.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1700 .TP
12013
d0a1e865c1af -vo directfb options by Jiri Svoboda
diego
parents: 11993
diff changeset
1701 .B \-dfbopts <value> (\-vo directfb only)
8900
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1702 Specify a parameter list for the directfb driver.
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1703 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1704 .B \-display <name> (X11 only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1705 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
1706 on.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1707 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1708 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1709 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1710 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1711 \-display xtest.localdomain:0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1712 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1713 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1714 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1715 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1716 .B \-double
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1717 Enables doublebuffering.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1718 Fixes flicker by storing two frames in memory, and displaying one while
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1719 decoding another.
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1720 Can affect OSD.
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
1721 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
1722 very little video memory.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1723 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1724 .B \-dr \ \ \
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1725 Turns on direct rendering (not supported by all codecs and video outputs)
13040
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1726 .br
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1727 .I WARNING:
3cc852100a37 another wrong style Warning
wight
parents: 13039
diff changeset
1728 May cause OSD/\:SUB corruption!
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1729 .TP
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1730 .B \-dxr2 <option1:option2:...>
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1731 This option is used to control the dxr2 driver.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1732 .
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1733 .RSs
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1734 .IPs ar-mode=<value>
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1735 aspect ratio mode (0 = normal, 1 = pan scan, 2 = letterbox (default))
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1736 .IPs iec958-encoded
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1737 iec958 output mode
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1738 .IPs iec958-decoded
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1739 set iec958 output mode to decoded (default)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1740 .IPs macrovision=<value>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1741 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
1742 3 = agc 4 colorstripe)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
1743 .IPs mute\
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1744 mute sound output
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1745 .IPs unmute
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1746 unmute sound output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1747 .IPs ucode=<value>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1748 path to the microcode
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1749 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1750 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1751 .sp 1
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1752 .I TV Out
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1753 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1754 .RSs
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1755 .IPs 75ire
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1756 enable 7.5 IRE output mode
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1757 .IPs no75ire
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1758 disable 7.5 IRE output mode (default)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1759 .IPs bw\ \ \
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1760 b/\:w TV output
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1761 .IPs color
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1762 color TV output (default)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1763 .IPs interlaced
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1764 interlaced TV output (default)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1765 .IPs nointerlaced
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1766 disable interlaced TV output
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1767 .IPs norm=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1768 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
1769 .IPs square-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1770 set pixel mode to square
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1771 .IPs ccir601-pixel
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1772 set pixel mode to ccir601
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1773 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1774 .RS
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1775 .sp 1
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1776 .I Overlay
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1777 .RE
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1778 .RSs
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1779 .IPs cr-left=<0\-500>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1780 set the left cropping value (default: 50)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1781 .IPs cr-right=<0\-500>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1782 set the right cropping value (default: 300)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1783 .IPs cr-top=<0\-500>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1784 set the top cropping value (default: 0)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1785 .IPs cr-bottom=<0\-500>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1786 set the bottom cropping value (default: 0)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1787 .IPs ck-[r|g|b]=<0\-255>
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1788 set the r(ed), g(reen) or b(lue) gain of the overlay color-key
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1789 .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
1790 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
1791 .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
1792 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
1793 .IPs ignore-cache
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1794 ignore cached overlay settings
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1795 .IPs update-cache
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1796 update cached overlay settings
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1797 .IPs ol-osd
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1798 enable overlay onscreen display
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1799 .IPs nool-osd
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1800 disable overlay onscreen display (default)
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1801 .IPs ol[h|w|x|y]-cor=<-20\-20>
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1802 adjust the overlay size (h,w) and position (x,y) in case it doesn't match the
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1803 window perfectly (default: 0)
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1804 .IPs overlay
10066
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1805 activate overlay (default)
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1806 .IPs nooverlay
c55cf2231b5a DXR2 option updates, description removed as it is present in HTML/XML.
diego
parents: 10063
diff changeset
1807 activate TVout
8132
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1808 .IPs overlay-ratio=<1\-2500>
06b20316d8cb DXR2 options updated, patch by Alban Bedel, <albeu@free.fr>.
diego
parents: 8082
diff changeset
1809 tune the overlay (default 1000)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1810 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1811 .
6747
8335b5a02032 Applied patch by Alban Bedel <albeu@free.fr>.
diego
parents: 6730
diff changeset
1812 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
1813 .B \-fb <device> (fbdev or DirectFB only) (OBSOLETE)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1814 Specifies the framebuffer device to use.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1815 By default it uses /dev/\:fb0.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1816 .TP
6469
caac66533fa0 Tons of typos plus wording updated here and there.
diego
parents: 6397
diff changeset
1817 .B \-fbmode <modename> (fbdev only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1818 Change video mode to the one that is labelled as <modename> in
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1819 /etc/\:fb.modes.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1820 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1821 .I NOTE:
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1822 VESA framebuffer doesn't support mode changing.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1823 .TP
6469
caac66533fa0 Tons of typos plus wording updated here and there.
diego
parents: 6397
diff changeset
1824 .B \-fbmodeconfig <filename> (fbdev only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1825 Use this configuration file instead of the default /etc/\:fb.modes.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1826 Only valid for the fbdev driver.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1827 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1828 .B \-forcexv (SDL only)
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1829 Force using XVideo.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1830 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
1831 .B \-fs \ \ \
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1832 Fullscreen playing (centers movie, and makes black
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1833 bands around it).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1834 Toggle it with the 'f' key (not all video outputs support it).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1835 See also \-zoom.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1836 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1837 .B \-fsmode-dontuse <0\-31> (OBSOLETE) (use \-fs option)
6071
506212428423 added new description, new vop options and fsmode-dontuse
jonas
parents: 6023
diff changeset
1838 Try this option if you still experience fullscreen problems.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1839 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1840 .B \-fstype <type1,type2,...> (X11 only)
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
1841 Specify a priority list of fullscreen layer setting modes to be
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
1842 used.
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
1843 The available types are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1844 .sp 1
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1845 .PD 0
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
1846 .RSs
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1847 .IPs above
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1848 Use _NETWM_STATE_ABOVE hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1849 .IPs below
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1850 Use _NETWM_STATE_BELOW hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1851 .IPs fullscreen
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1852 Use _NETWM_STATE_FULLSCREEN hint if available.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1853 .IPs layer
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1854 Use _WIN_LAYER hint with default layer.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1855 .IPs layer=<0..15>
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1856 Use _WIN_LAYER hint with layer number.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1857 .IPs netwm
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1858 Force NETWM style.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1859 .IPs none\
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1860 Don't set fullscreen window layer.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1861 .IPs stays_on_top
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1862 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
1863 .RE
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1864 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1865 .TP
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1866 .B \
11164
33aaf024ddd1 small fixes
diego
parents: 11144
diff changeset
1867 You can negate the modes by prefixing them with '-'.
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
1868 .br
11164
33aaf024ddd1 small fixes
diego
parents: 11144
diff changeset
1869 The default order is layer,stays_on_top,above,fullscreen.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1870 It will be used as a fallback in case of specifying incorrect
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
1871 or unsupported modes.
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
1872 .br
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
1873 OpenBox 1.x users have to use \-fstype \-fullscreen
10703
126f2149e8f3 10l and a few spelling fixes
diego
parents: 10700
diff changeset
1874 to achieve working fs switching.
10695
879ce4016b34 Commit alex's fstype patch x11_common.c3.diff with additional manpage extension.
attila
parents: 10688
diff changeset
1875 .br
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
1876 If you experience problems with fullscreen window being covered by other
9474
569fd232427a Cosmetics: a linebreak and a small grammar correction
diego
parents: 9469
diff changeset
1877 windows try using a different order.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1878 .br
9338
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
1879 .I NOTE:
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
1880 See \-fstype help for a full list of available modes.
3d5fe5fe4aa9 Document -fstype in manpage.
filon
parents: 9334
diff changeset
1881 .TP
8745
93f78fb709e6 Added support for X style -geometry options (adapted from Henk's patch)
mark
parents: 8708
diff changeset
1882 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
1883 Adjust where the output is on the screen initially.
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
1884 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
1885 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
1886 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
1887 screen size in that direction.
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1888 It also supports the standard option format to the standard X \-geometry
add58e42a878 bandwidth, cuefile/vcd, osdlevel, dfbopts, eq2, bmovl, lavc: vstrict, psnr, removed yvu9, some cosmetics
jonas
parents: 8891
diff changeset
1889 option.
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
1890 The values given must be integers.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1891 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1892 .I NOTE:
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
1893 This option is only supported by vo x11, xmga, xv, xvmc, xvidix,
10906
e00bb9e4bac7 directx now supports geometry.
diego
parents: 10903
diff changeset
1894 directx and tdfxfb.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1895 .sp 1
8140
8655d0d228b1 merged with Jonas' version sent a week ago
arpi
parents: 8132
diff changeset
1896 .I EXAMPLE:
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1897 .PD 0
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1898 .RSs
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1899 .IPs 50:40
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
1900 Places the window at x=50, y=40.
7866
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1901 .IPs 50%:50%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
1902 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
1903 .IPs 100%\
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
1904 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
1905 .IPs 100%:100%
12045
82c990567130 -geometry examples corrected.
diego
parents: 12044
diff changeset
1906 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
1907 .RE
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1908 .PD 1
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1909 .
732a8bfc7681 Added the -geometry option (supports fbdev and tdfxfb drivers)
mark
parents: 7864
diff changeset
1910 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
1911 .B \-guiwid <window\ id> (GUI only)
9334
f6007efc714f spelling
diego
parents: 9314
diff changeset
1912 This tells the GUI to also use an X11 window and stick itself to the bottom
f6007efc714f spelling
diego
parents: 9314
diff changeset
1913 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
1914 MPlayer plugin for instance).
9314
f38fe55d0e05 this patch adds the option -guiwid to gmplayer. I think its a more clean
arpi
parents: 9309
diff changeset
1915 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1916 .B \-hue <-100\-100>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1917 Adjust hue of video signal (default: 0).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1918 You can get colored negative of image with this option.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1919 .TP
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1920 .B \-jpeg <option1:option2:...> (\-vo jpeg only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1921 Specify options for the JPEG output.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1922 .br
9244
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1923 Available options are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1924 .sp 1
9244
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1925 .PD 0
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1926 .RSs
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1927 .IPs [no]progressive
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1928 Specify standard or progressive JPEG.
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1929 .IPs [no]baseline
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1930 Specify use of baseline or not.
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1931 .IPs optimize=<value>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1932 Optimization factor [0\-100]
9244
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1933 .IPs smooth=<value>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1934 Smooth factor [0\-100]
9244
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1935 .IPs quality=<value>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1936 Quality factor [0\-100]
9244
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1937 .IPs outdir=<value>
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1938 Directory to save the JPEG files
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1939 .RE
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1940 .PD 1
073b1ca3f3d7 Better description of -jpeg options, patch by Colin Leroy.
diego
parents: 9236
diff changeset
1941 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1942 .TP
12855
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1943 .B \-monitor-dotclock <range[,range,...]> (fbdev and vesa only)
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1944 Specify the dotclock or pixelclock range of the monitor.
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1945 .TP
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1946 .B \-monitor-hfreq <range[,range,...]> (fbdev and vesa only)
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1947 Specify the horizontal frequency range of the monitor.
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1948 .TP
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1949 .B \-monitor-vfreq <range[,range,...]> (fbdev and vesa only)
c03ce92291b6 -monitor-* options corrected.
diego
parents: 12854
diff changeset
1950 Specify the vertical frequency range of the monitor.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1951 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1952 .B \-monitoraspect <ratio>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1953 Set aspect ratio of your monitor or TV screen.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1954 See also \-aspect for movie aspect.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
1955 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
1956 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1957 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1958 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1959 \-monitoraspect 4:3 or 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1960 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1961 \-monitoraspect 16:9 or 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1962 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1963 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
1964 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1965 .TP
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
1966 .B \-nograbpointer
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1967 Do not grab mouse pointer after VidMode change (\-vm), useful for multihead
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1968 setup.
8692
604f0cde816c X11 window aspect patch by Arnaud Boulan <boulan@iie.cnam.fr>
attila
parents: 8685
diff changeset
1969 .TP
12388
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
1970 .B \-nokeepaspect
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
1971 Do not keep window aspect ratio when resizing windows (Works currently only
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
1972 with \-vo x11, xv, xmga, xvidix, directx and under X11 your window manager
ca026dc6b44d vo_directx now supports keepaspect.
diego
parents: 12366
diff changeset
1973 needs to understand window aspect hints.).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
1974 .TP
10991
e65b09eb0a2a sdl only -noxv
alex
parents: 10974
diff changeset
1975 .B \-noxv (SDL only)
e65b09eb0a2a sdl only -noxv
alex
parents: 10974
diff changeset
1976 Disables XVideo SDL driver.
e65b09eb0a2a sdl only -noxv
alex
parents: 10974
diff changeset
1977 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
1978 .B \-ontop
11542
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
1979 Makes the player window stay on top other windows.
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
1980 Supported by drivers which use X11, except SDL, as well as directx and gl2 under Windows.
85e503ddf65f runtime 'stay-on-top' functionality
joey
parents: 11539
diff changeset
1981 .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
1982 .B \-panscan <0.0\-1.0>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1983 Enables Pan & Scan functionality, i.e.\& in order to display a 16:9 movie
6351
91673ed4e773 -panscan clarified
diego
parents: 6338
diff changeset
1984 on a 4:3 display, the sides of the movie are cropped to get a 4:3 image
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1985 which fits the screen.
8435
930acd4ce715 -format, -lavcdeint, -2xsai and small fixes.
diego
parents: 8424
diff changeset
1986 This function works only with the xv, xmga, mga and xvidix video out drivers.
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
1987 .br
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
1988 The range controls how much of the image is cropped.
6330
68a3003b57ce panscan added
gabucino
parents: 6326
diff changeset
1989 .TP
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1990 .B \-refreshrate <Hz>
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1991 Set the monitor refreshrate in Hz.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1992 Currently only supported by \-vo directx combined with the \-vm option.
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
1993 .TP
13005
8d37cc41a272 -rootwin is no longer X11 only.
diego
parents: 13002
diff changeset
1994 .B \-rootwin
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
1995 Play movie in the root window (desktop background) instead of opening
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
1996 a new one.
13005
8d37cc41a272 -rootwin is no longer X11 only.
diego
parents: 13002
diff changeset
1997 Works only with the x11, xv, xmga, xvidix and quartz video output drivers.
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
1998 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
1999 .B \-saturation <-100\-100>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2000 Adjust saturation of video output (default: 0).
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2001 You can get grayscale output with this option.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2002 .TP
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2003 .B \-screenh <pixels> \-screenw <pixels>
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2004 If you use an output driver which can't know the resolution of the screen
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2005 (fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2006 vertical resolution.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2007 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2008 .B \-stop-xscreensaver (X11 only)
7637
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2009 Turns off xscreensaver at startup and turns it on again on exit.
da21af0b1f1b various fixes, new options
arpi
parents: 7635
diff changeset
2010 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2011 .B \-vm \ \ \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2012 Try to change to a better video mode.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2013 dga, x11/\:xv (XF86VidMode) and sdl output drivers support it.
12040
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2014 If it is used with the directx video output driver the \-screenw,
cdc4feff6023 -adapter, -refreshrate options, based on patch by Sascha Sommer
diego
parents: 12036
diff changeset
2015 \-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
2016 the new display mode.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2017 .TP
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2018 .B \-vsync \ \
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
2019 Enables VBI for vesa.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2020 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2021 .B \-wid <window\ id> (X11 only)
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2022 This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
2023 browser (with the plugger extension for instance).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2024 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2025 .B \-xineramascreen <0\-...>
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2026 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2027 displays) this option tells MPlayer which screen to display movie on.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2028 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2029 .B \-z <0\-9> (-vo png only)
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2030 Specifies compression level for PNG output.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2031 .
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2032 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2033 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2034 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2035 no compression
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2036 .IPs 9
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2037 max compression
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2038 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2039 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2040 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2041 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2042 .B \-zrbw (\-vo zr only)
7192
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2043 Display in black and white (for optimal performance, this option can be
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2044 combined with the 'decode only in black and white' option for codecs
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2045 belonging to the FFmpeg family).
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2046 .TP
7219
32e8afc0a057 cosmetics, 10l at beginning, no real changes
jonas
parents: 7192
diff changeset
2047 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
7192
f771e685f3b1 Zr documentation updated plus some typos fixed.
diego
parents: 7189
diff changeset
2048 Select a part of the input image for display, multiple occurences of this
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2049 option switch on cinerama mode.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2050 In cinerama mode the movie is distributed over more than one TV (or beamer) to
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2051 create a larger screen.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2052 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
2053 card should at least have a \-zrdev in addition to the \-zrcrop.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2054 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
2055 documentation.
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2056 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2057 .B \-zrdev <device> (\-vo zr only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2058 Specify the device special file that belongs to your MJPEG card, by default
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2059 this driver takes the first v4l device it can find.
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2060 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2061 .B \-zrfd (\-vo zr only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2062 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2063 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
2064 Use this option to force decimation.
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2065 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2066 .B \-zrhelp (\-vo zr only)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2067 Display a list of all \-zr* options, their default values and an example of
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2068 cinerama mode.
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2069 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2070 .B \-zrnorm <norm> (\-vo zr only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2071 Specify norm PAL/\:NTSC, the default is 'no change'.
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2072 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2073 .B \-zrquality <1\-20> (\-vo zr only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2074 A number from 1 to 20 representing the jpeg encoding quality.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2075 1 gives the best quality and 20 gives very bad quality.
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2076 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2077 .B \-zrvdec <1,2,4> \-zrhdec <1,2,4> (\-vo zr only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2078 Vertical/\:horizontal decimation: Ask the driver to send only every 2nd or 4th
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2079 line/\:pixel of the input image to the MJPEG card and use the scaler of the
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2080 MJPEG card to strech the image to its original size.
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2081 .TP
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2082 .B \-zrxdoff <x display offset>, \-zrydoff <y display offset> (\-vo zr only)
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
2083 If the movie is smaller than the TV screen, these options control the position
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2084 of the movie relative to the upper left corner of the screen.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2085 The movie is centered by default.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2086 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2087 .
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2088 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2089 Video output drivers are interfaces to different output facilities.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2090 The syntax is:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2091 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2092 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2093 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
2094 .PP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2095 If the list has a trailing ',' it will fall back to drivers not listed on the
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2096 command line.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2097 Suboptions are optional and can mostly be omitted.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2098 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2099 .I NOTE:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2100 See \-vo help for a list of compiled-in drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2101 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2102 .I EXAMPLE:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2103 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2104 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2105 .IPs "\-vo xmga,xv,"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2106 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
2107 .IPs "\-vo directx:noaccel"
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2108 Uses the DirectX driver with acceleration features turned off.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2109 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2110 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2111 .
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2112 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2113 FIXME: Document suboptions for x11, xover, dga, sdl, vidix, xvidix, fbdev,
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2114 fbdev2, vesa, svga, null, aa, bl, ggi, mga, xmga, syncfb, 3dfx, tdfx_vid,
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2115 tdfxfb, dxr2, dxr3, mpegpes, zr, zr2, yuv4mpeg, gif89a, jpeg, pgm, png, tga.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2116 .sp 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2117 Available video output drivers are:
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2118 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2119 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2120 .B xv (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2121 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
2122 accelerated playback.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2123 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
2124 the best option.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2125 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2126 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2127 .IPs port=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2128 Select a specific XVideo port.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2129 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2130 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2131 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2132 .B x11 (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2133 Shared memory output driver without hardware acceleration that
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2134 works whenever X11 is present.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2135 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2136 .B xover (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2137 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
2138 Currently only supported by tdfx_vid.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2139 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2140 .B xvmc (X11, \-vc ffmpeg12mc only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2141 Video output driver that uses the XvMC (X Video Motion Compensation)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2142 extension of XFree86 4.x to speed up MPEG1/2 and VCR2 decoding.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2143 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2144 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2145 .IPs benchmark
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2146 Disables image display.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2147 Necessary for proper benchmarking of drivers that change
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2148 image buffers on monitor retrace only (nVidia).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2149 .IPs queue
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2150 Queue frames for display to allow more parallel work of the video hardware.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2151 May add a small (not noticeable) constant A/V desync.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2152 .IPs sleep
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2153 Use sleep function while waiting for rendering to finish
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2154 (not recomended on Linux).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2155 .IPs wait\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2156 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
2157 (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2158 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2159 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2160 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2161 .B dga (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2162 Output video through the XFree86 Direct Graphics Access extension.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2163 Considered obsolete.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2164 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2165 .B sdl (SDL only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2166 Highly platform independent SDL (Simple Directmedia Layer) library
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2167 video output driver.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2168 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2169 .B vidix\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2170 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
2171 video acceleration features of different graphics cards.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2172 Very fast output driver on cards that support it.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2173 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2174 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2175 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2176 Explicitly choose the VIDIX subdevice driver to use.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2177 Available subdevice drivers are cyberblade_vid, mach64_vid, mga_crtc2_vid,
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2178 mga_vid, nvidia_vid, pm3_vid, radeon_vid, rage128_vid, sis_vid.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2179 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2180 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2181 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2182 .B xvidix (X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2183 X11 frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2184 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2185 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2186 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2187 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2188 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2189 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2190 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2191 .B cvidix\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2192 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
2193 textconsole with nVidia cards.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2194 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2195 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2196 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2197 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2198 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2199 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2200 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2201 .B winvidix (Windows only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2202 Windows frontend for VIDIX
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2203 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2204 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2205 .IPs <subdevice>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2206 same as vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2207 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2208 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2209 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2210 .B directx (Windows only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2211 Output driver that uses the DirectX interface.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2212 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2213 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2214 .IPs noaccel
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2215 Turns off hardware acceleration.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2216 Try this option if you have display problems.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2217 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2218 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2219 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2220 .B quartz (Mac OS X only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2221 Mac OS X Quartz output driver.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2222 Under some circumstances, it might be more efficient to force a
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2223 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
2224 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2225 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2226 .IPs device_id=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2227 Choose the display device to use in fullscreen.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2228 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2229 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2230 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2231 .B fbdev (Linux only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2232 Uses the kernel framebuffer to output video.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2233 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2234 .B fbdev2 (Linux only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2235 Uses the kernel framebuffer to output video,
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2236 alternative implementation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2237 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2238 .B vesa\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2239 Very general output driver that should work on any VESA VBE 2.0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2240 compatible card.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2241 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2242 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2243 .IPs dga\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2244 Turns on DGA mode.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2245 .IPs nodga
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2246 Turns off DGA mode.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2247 .IPs vidix
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2248 FIXME: document this
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2249 .IPs lvo\ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2250 FIXME: document this
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2251 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2252 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2253 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2254 .B svga\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2255 Output video using the SVGA library.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2256 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2257 .B gl\ \ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2258 OpenGL output driver.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2259 Very simple version, no OSD support and video size must be smaller than
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2260 the maximum texture size of your OpenGL implementation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2261 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
2262 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2263 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2264 .IPs manyfmts
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2265 Enables support for more (RGB and BGR) color formats.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2266 Needs OpenGL version >= 1.2, NOT yet WORKING correctly.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2267 .IPs slice-height=<0\-...>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2268 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
2269 0 for whole image.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2270 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2271 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2272 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2273 .B gl2\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2274 OpenGL output driver, second generation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2275 Supports OSD and videos larger than the maximum texture size.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2276 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2277 .B null\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2278 Produces no video output.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2279 Useful for benchmarking.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2280 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2281 .B aa\ \ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2282 ASCII art output driver that works on a text console.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2283 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2284 .B caca\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2285 Colour AsCii Art output driver that works on a text console.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2286 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2287 .B bl\ \ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2288 Video playback using the Blinkenlights UDP protocol.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2289 This driver is highly hardware specific.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2290 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2291 .B ggi\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2292 Output driver for the GGI graphics system.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2293 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2294 .B directfb
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2295 Play video using the DirectFB library.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2296 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2297 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2298 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2299 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
2300 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2301 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
2302 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
2303 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2304 Single buffering should be avoided (default: single).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2305 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2306 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2307 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
2308 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
2309 like most MPEG movies are.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2310 You need to enable this option if you have tearing issues/unsmooth
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2311 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2312 .IPs layer=N
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2313 Will force layer with id N for playback (default: -1 - auto).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2314 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2315 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2316 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2317 .B dfbmga\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2318 Matrox G400/G450/G550 specific output driver that uses the DirectFB library.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2319 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
2320 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2321 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2322 .IPs (no)bes
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2323 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
2324 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
2325 picture processing is done in hardware.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2326 Works only on the primary head.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2327 .IPs (no)spic
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2328 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
2329 .IPs (no)crtc2
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2330 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
2331 The output quality is amazing as it's a full interlaced picture
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2332 with proper sync to every odd/even field.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2333 .IPs (no)input
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2334 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
2335 .IPs buffermode=single|double|triple
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2336 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
2337 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
2338 while waiting for the vertical retrace.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2339 Single buffering should be avoided (default: triple).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2340 .IPs fieldparity=top|bottom
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2341 Control the output order for interlaced frames (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2342 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
2343 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
2344 like most MPEG movies are.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2345 You need to enable this option if you have tearing issues/unsmooth
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2346 motions watching interlaced film material.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2347 .IPs tvnorm=pal|ntsc|auto
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2348 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
2349 for modifying /etc/\:directfbrc (default: disabled).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2350 Valid norms are pal = PAL, ntsc = NTSC.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2351 Special norm is auto (auto-adjust using PAL/NTSC) because it decides
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2352 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
2353 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2354 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2355 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2356 .B mga (Linux only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2357 Matrox specific output driver that makes use of the YUV back
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2358 end scaler on Gxxx cards through a kernel module.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2359 If you have a Matrox card, this is the fastest option.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2360 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2361 .B xmga (Linux, X11 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2362 The mga output driver, running in an X11 window.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2363 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2364 .B syncfb\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2365 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
2366 special hardware features of Matrox Gxxx cards like hardware
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2367 deinterlacing, scaling and synchronizing your video output to
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2368 the vertical retrace of your monitor.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2369 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2370 .B 3dfx (Linux only)
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2371 3Dfx specific output driver.
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2372 FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2373 .TP
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2374 .B tdfxfb (Linux only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2375 This driver employs the tdfx framebuffer driver to play movies with
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2376 YUV acceleration.
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2377 FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2378 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2379 .B tdfx_vid (Linux only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2380 3Dfx specific output driver.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2381 Works in conjunction with a kernel module.
12986
7279711f10bc vo_tdfxfb
diego
parents: 12978
diff changeset
2382 FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2383 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2384 .B dxr2 (also see \-dxr2) (DXR2 only)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2385 Creative DXR2 specific output driver.
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 x11
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2389 Enables overlay.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2390 .IPs xv
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2391 Enables overlay.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2392 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2393 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2394 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2395 .B dxr3 (DXR3 only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2396 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2397 Hollywood Plus) specific output driver.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2398 Also see the lavc video filter.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2399 .PD 0
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2400 .RSs
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2401 .IPs overlay
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2402 Activates the overlay instead of TVOut.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2403 .IPs prebuf
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2404 Turns on prebuffering.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2405 .IPs sync
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2406 Will turn on the new sync-engine.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2407 .IPs norm=<norm>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2408 Specifies the TV norm.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2409 .RSss
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2410 0: Does not change current norm (default).
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2411 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2412 1: Auto-adjust using PAL/NTSC.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2413 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2414 2: Auto-adjust using PAL/PAL-60.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2415 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2416 3: PAL
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2417 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2418 4: PAL-60
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2419 .br
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2420 5: NTSC
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2421 .REss
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2422 .IPs device=<number>
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2423 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
2424 .RE
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2425 .PD 1
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2426 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2427 .B mpegpes (DVB only)
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2428 DVB specific output driver.
13049
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2429 .PD 0
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2430 .RSs
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2431 .IPs card=<1\-4>
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2432 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
2433 (V3 API only, such as 1.x.y series drivers).
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2434 .RE
d28cf4323861 user can select which dvb card to use as vo
nicodvb
parents: 13046
diff changeset
2435 .PD 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2436 .TP
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
2437 .B zr (also see \-zr* and \-zrhelp)
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2438 Output driver for a number of MJPEG capture/playback cards.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2439 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2440 .B zr2\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2441 Output driver for a number of MJPEG capture/playback cards, second generation.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2442 Also see the zrmjpeg video filter.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2443 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2444 .B md5\ \ \ \
12944
73cb43ad38ff even better -vo md5 description
diego
parents: 12938
diff changeset
2445 Generates images from each frame with the help of \-vo pgm and writes
73cb43ad38ff even better -vo md5 description
diego
parents: 12938
diff changeset
2446 their MD5 sums into a file.
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2447 Useful for debugging.
12934
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2448 .PD 0
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2449 .RSs
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2450 .IPs filename
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2451 Allows specifying the output filename (default: ./md5).
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2452 .RE
34394ef08238 Better documentation for -vo md5.
diego
parents: 12933
diff changeset
2453 .PD 1
12716
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2454 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2455 .B yuv4mpeg
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2456 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
2457 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
2458 directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2459 Useful if you want to process the video with the mjpegtools suite.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2460 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2461 .B gif89a\
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2462 Output each frame into a GIF file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2463 Each file takes the frame number padded with leading zeros as name.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2464 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2465 .B jpeg\ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2466 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
2467 Each file takes the frame number padded with leading zeros as name.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2468 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2469 .B pgm\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2470 Output each frame into a PGM file in the current directory.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2471 Each file takes the frame number padded with leading zeros as name.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2472 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2473 .B png\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2474 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
2475 Each file takes the frame number padded with leading zeros as name.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2476 .TP
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2477 .B tga\ \ \ \
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2478 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
2479 Each file takes the frame number padded with leading zeros as name.
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2480 .
296b1f6f6bf7 VIDEO OUTPUT DRIVERS moved right after VIDEO OUTPUT OPTIONS.
diego
parents: 12715
diff changeset
2481 .
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
2482 .SH "DECODING/FILTERING OPTIONS"
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2483 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2484 .B \-ac <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2485 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
2486 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2487 Use a '-' before the codec name to omit it.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2488 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2489 .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
2490 See \-ac help for a full list of available codecs.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2491 .br
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2492 If the list has a trailing ',' it will fallback to codecs not listed.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2493 .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
2494 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2495 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2496 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2497 .IPs "\-ac mp3acm"
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2498 force l3codeca.acm MP3 codec
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2499 .IPs "\-ac mad,"
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2500 try libmad first, then fallback to others
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2501 .IPs "\-ac hwac3,a52,"
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2502 try hardware AC3 passthrough, then software AC3 codec, then others
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2503 .IPs "\-ac -ffmp3,"
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2504 try other codecs except FFmpeg's MP3 decoder
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2505 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2506 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2507 .
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
2508 .TP
12597
5c6185a8d5e8 Better audio filter description, use same values as in the XML docs,
diego
parents: 12595
diff changeset
2509 .B \-af <filter1[=option1:option2:...],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
2510 Activate a comma separated list of audio filters and their 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
2511 .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
2512 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
2513 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2514 .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
2515 .IPs resample[=srate[:sloppy][:type]]
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2516 Changes the sample rate of the audio stream to an integer srate (Hz).
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
2517 It only supports the 16-bit little-endian format.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2518 .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
2519 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
2520 If the number of output channels is bigger 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
2521 empty channels are inserted (except mixing from mono to stereo, then the 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
2522 channel is repeated in both of the 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
2523 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
2524 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
2525 .IPs format[=bps:f]
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
2526 Select the format f and bytes per sample bps 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
2527 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
2528 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
2529 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
2530 .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
2531 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
2532 .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
2533 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
2534 .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
2535 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
2536 .br
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
2537 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
2538 .br
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2539 .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
2540 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
2541 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
2542 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
2543 .RSss
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2544 v: desired gain in dB for all channels in the stream.
12597
5c6185a8d5e8 Better audio filter description, use same values as in the XML docs,
diego
parents: 12595
diff changeset
2545 The gain can be set from -200dB to +60dB (where -200dB mutes the sound
5c6185a8d5e8 Better audio filter description, use same values as in the XML docs,
diego
parents: 12595
diff changeset
2546 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
2547 .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
2548 sc: enable soft clipping.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2549 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2550 .IPs pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]
11185
ee8da27cade7 more docs path fixes
diego
parents: 11181
diff changeset
2551 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
2552 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2553 n: number of output 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
2554 .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
2555 lij: how much of input channel j is mixed into output channel i.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2556 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2557 .IPs sub[=fc:ch]
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2558 Add sub-woofer channel.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2559 .RSss
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2560 fc: Cutoff frequency for low-pass filter (20Hz to 300Hz) default is 60Hz.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2561 .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
2562 ch: channel number for the sub-channel.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2563 .REss
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2564 .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
2565 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
2566 .RSss
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2567 d: delay time in ms for the rear speakers (0ms to 1000ms) default is 15ms.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2568 .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
2569 .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
2570 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
2571 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
2572 number between 0 and 1000).
11366
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2573 .IPs export[=mmapped_file[:nsamples]]
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2574 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
2575 .RSss
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2576 mmapped_file: File to map data to (default: ~/.mplayer/mplayer-af_export).
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2577 .br
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2578 nsamples: number of samples per channel (default: 512)
3d38013edd45 Export audio filter documentation by Gustavo Sverzut Barbieri
diego
parents: 11365
diff changeset
2579 .REss
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2580 .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
2581 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2582 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2583 .B \-af-adv <force=(0\-3):list=(filters)> (see \-af option too)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2584 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
2585 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2586 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2587 .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
2588 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
2589 .RSss
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2590 0: Completely automatic insertion of filters (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
2591 .br
11858
rfelker
parents: 11840
diff changeset
2592 1: Optimize for accuracy
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2593 .br
11858
rfelker
parents: 11840
diff changeset
2594 2: Optimize for speed
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2595 .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
2596 3: Turn off 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
2597 .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
2598 .IPs list=<filters>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2599 Same as \-af (see \-af option).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2600 .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
2601 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
2602 .TP
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2603 .B \-afm <driver1,driver2,...>
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2604 Specify a priority list of audio drivers to be used, according to their driver
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2605 name in codecs.conf.
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2606 It falls back to default if none is OK.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2607 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2608 .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
2609 See \-afm help for a full list of available drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2610 .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
2611 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2612 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2613 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2614 .IPs "\-afm ffmpeg"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2615 Try FFmpeg's libavcodec (mp1/\:2/\:3) codecs first.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2616 .IPs "\-afm acm,dshow"
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2617 try Win32 codecs first
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2618 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2619 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2620 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2621 .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
2622 .B \-aspect <ratio>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2623 Override aspect ratio of movies.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2624 It's autodetected on MPEG files, but can't be autodetected on most AVI files.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2625 .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
2626 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2627 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2628 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2629 \-aspect 4:3 or \-aspect 1.3333
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2630 .br
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2631 \-aspect 16:9 or \-aspect 1.7777
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2632 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2633 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2634 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2635 .TP
12044
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2636 .B \-noaspect
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2637 Disable automatic movie aspect ratio compensation.
9695d7a299dc 100l bug fixes, -noaspect moved just below -aspect.
diego
parents: 12040
diff changeset
2638 .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
2639 .B \-flip \
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
2640 Flip image upside-down.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2641 .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
2642 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
9622
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2643 If decoding with libavcodec, you can specify its parameters here.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2644 .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
2645 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2646 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2647 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2648 \-lavdopts bug=1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2649 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2650 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2651 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
2652 .RS
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2653 .I NOTE:
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2654 Just add the values of the things you want to enable.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2655 .br
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2656 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
2657 .RE
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2658 .
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2659 .RSs
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2660 .IPs ec\ \ \
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2661 error concealment:
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2662 .RSss
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2663 1: use strong deblock filter for damaged MBs
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2664 .br
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2665 2: iterative MV search (slow)
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2666 .br
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2667 3: all (default)
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2668 .REss
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2669 .IPs er=<value>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2670 error resilience:
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2671 .RSss
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2672 .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
2673 0: disabled
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2674 .br
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
2675 1: careful (should work with broken encoders)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2676 .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
2677 2: normal (default) (works with compliant encoders)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2678 .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
2679 3: agressive (more checks but might cause problems even for valid bitstreams)
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2680 .br
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2681 4: very agressive
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2682 .REss
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2683 .IPs debug=<value>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2684 debug:
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2685 .RSss
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2686 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2687 0: disabled
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2688 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2689 1: picture info
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2690 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2691 2: rate control
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2692 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2693 4: bitstream
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2694 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2695 8: MB type
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2696 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2697 16: QP
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2698 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2699 32: Motion vector
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2700 .br
11443
932a8311f2e8 missing \ before -
wight
parents: 11430
diff changeset
2701 0x0040: Motion vector visualization (use \-noslices)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2702 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2703 0x0080: MB skip
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2704 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2705 0x0100: startcode
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2706 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2707 0x0200: PTS
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2708 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2709 0x0400: error resilience
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2710 .br
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2711 0x0800: memory management control operations (H.264)
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2712 .br
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2713 0x1000: bugs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
2714 .REss
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2715 .IPs vismv=<value>
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2716 vismv:
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2717 .RSss
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2718 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2719 0: disabled
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2720 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2721 1: visualize forward predicted MVs of P frames
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2722 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2723 2: visualize forward predicted MVs of B frames
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2724 .br
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2725 4: visualize backward predicted MVs of B frames
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
2726 .REss
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2727 .IPs bug=<value>
7701
cec4eca0a879 Man page review part one, spelling, rewording and layout fixes.
diego
parents: 7637
diff changeset
2728 manually work around encoder bugs:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2729 .RSss
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2730 0: nothing
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2731 .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
2732 1: autodetect bugs (default)
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2733 .br
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2734 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetect)
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
2735 .br
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
2736 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2737 .br
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2738 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
2739 .br
9622
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2740 16 (mpeg4): padding bug (autodetected)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2741 .br
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
2742 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
2743 .br
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
2744 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/ver)
9622
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2745 .br
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2746 128 (mpeg4): old standard qpel (autodetected per fourcc/ver)
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2747 .br
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2748 256 (mpeg4): another qpel bug (autodetected per fourcc/ver)
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2749 .br
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2750 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/ver)
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2751 .br
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2752 1024 (mpeg4): edge padding bug (autodetected per fourcc/ver)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2753 .REss
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
2754 .IPs idct=<0\-99>
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
2755 (see lavcopts)
9622
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2756 For best decoding quality use the same idct algorithm for decoding and encoding.
78ef5d3126b2 Finally merged libavc-option.txt into the man page.
diego
parents: 9620
diff changeset
2757 This may come at a price in accuracy, though.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
2758 .IPs gray\
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
2759 grayscale only decoding (a bit faster than with color)
13036
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
2760 .IPs "sb=<number> (MPEG2 only)"
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
2761 Skip the given number of macroblock rows at the bottom.
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
2762 .IPs "st=<number> (MPEG2 only)"
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
2763 Skip the given number of macroblock rows at the top.
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
2764 .IPs vstats
9ce2d17513ee 10l, sb, st and vstats are lavc _de_coding, not _en_coding options.
diego
parents: 13031
diff changeset
2765 Prints some statistics and stores them in ./vstats_*.log.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2766 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2767 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2768 .TP
10617
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
2769 .B \-noslices
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
2770 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
2771 whole frame in a single run.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
2772 May be faster or slower, depending on card/\:cache.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
2773 It has effect only with libmpeg2 and libavcodec codecs.
4b9c5abf2f60 -(no)slices is no longer MPlayer only.
diego
parents: 10615
diff changeset
2774 .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
2775 .B \-nosound
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2776 Do not play/\:encode sound.
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
2777 Useful for benchmarking.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2778 .TP
10072
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
2779 .B \-novideo
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
2780 Do not play/\:encode video.
fa013cb66325 -novideo documented
diego
parents: 10071
diff changeset
2781 .TP
12330
343568042bfa Mark all options that work only in combination with XXX as (XXX only).
diego
parents: 12311
diff changeset
2782 .B \-oldpp <quality> (OBSOLETE) (OpenDivX only)
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
2783 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
2784 Superseded by \-pp, the internal postprocessing offers better
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
2785 quality and performance.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2786 .
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
2787 The valid range of \-oldpp values varies by codec, mostly
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
2788 0\-6, where 0=disable 6=slowest/\:best.
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
2789 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2790 .B \-pp <quality> (see \-vf pp option too!)
8616
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
2791 Set postprocess level of the DLL.
4dd84fd2d208 cosmetics
jonas
parents: 8610
diff changeset
2792 This option is NO LONGER USABLE with MPlayer's postprocess filter, but only
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
2793 with Win32 DirectShow DLLs which have internal postprocessing routines.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2794 .
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
2795 The valid range of \-pp values varies by codec, mostly
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2796 0\-6, where 0=disable 6=slowest/\:best.
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
2797 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2798 .B \-pphelp (see \-vf pp option too)
8806
1a308d921475 updates
jonas
parents: 8762
diff changeset
2799 Show a summary about the available postprocess filters and their usage.
1a308d921475 updates
jonas
parents: 8762
diff changeset
2800 .TP
7488
f5393c6c0cce some updates
arpi
parents: 7450
diff changeset
2801 .B \-ssf <mode>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2802 Specifies SwScaler parameters.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2803 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2804 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2805 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2806 .RSs
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2807 \-vf scale \-ssf lgb=3.0
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2808 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2809 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2810 .
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2811 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2812 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2813 .IPs lgb=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2814 Gaussian blur filter (luma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2815 .IPs cgb=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2816 Gaussian blur filter (chroma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2817 .IPs ls=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2818 sharpen filter (luma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2819 .IPs cs=<0\-100>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2820 sharpen filter (chroma)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2821 .IPs chs=<h>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2822 chroma horizontal shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2823 .IPs cvs=<v>
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2824 chroma vertical shifting
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2825 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2826 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2827 .
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
2828 .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
2829 .B \-stereo <mode>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2830 Select type of MP2/\:MP3 stereo output.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2831 .
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2832 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2833 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2834 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2835 Stereo
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2836 .IPs 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2837 Left channel
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2838 .IPs 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2839 Right channel
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2840 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2841 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2842 .
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
2843 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2844 .B \-sws <software\ scaler\ type> (see \-vf scale option too)
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
2845 This option sets the quality (and speed, respectively) of the software scaler,
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2846 with the \-zoom option.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2847 For example with x11 or other outputs which lack hardware acceleration.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2848 Possible settings are:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2849 .br
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2850 .I NOTE:
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2851 For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p)
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2852 of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
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
2853 length (1 \- 10).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2854 .sp 1
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2855 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2856 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2857 .IPs 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2858 fast bilinear (default)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2859 .IPs 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2860 bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2861 .IPs 2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2862 bicubic (good quality)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2863 .IPs 3
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2864 experimental
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2865 .IPs 4
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2866 nearest neighbour (bad quality)
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2867 .IPs 5
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2868 area
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2869 .IPs 6
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2870 luma bicubic / chroma bilinear
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2871 .IPs 7
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2872 gauss
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2873 .IPs 8
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2874 sincR
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2875 .IPs 9
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2876 lanczos
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2877 .IPs 10
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2878 bicubic spline
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2879 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2880 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2881 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2882 .TP
7635
6409b0ac8640 fixed -ac/vc/ao/vo/afm/vfm stuff
arpi
parents: 7632
diff changeset
2883 .B \-vc <[-]codec1,[-]codec2,...[,]>
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2884 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
2885 name in codecs.conf.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2886 Use a '-' before the codec name to omit it.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2887 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2888 .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
2889 See \-vc help for a full list of available codecs.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2890 .br
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2891 If the list has a trailing ',' it will fallback to codecs not listed.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2892 .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
2893 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2894 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2895 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2896 .IPs "\-vc divx"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2897 Force Win32/\:VFW DivX codec, no fallback.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2898 .IPs "\-vc divx4,"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2899 Try divx4linux codec first, then fall back to others.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2900 .IPs "\-vc -divxds,-divx,"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2901 Try other codecs except Win32 DivX codecs.
7600
4ec0a7228b81 new ac/vc/afm/vfm/ao/vo options
jonas
parents: 7576
diff changeset
2902 .IPs "\-vc ffmpeg12,mpeg12,"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2903 Try libavcodec's MPEG1/\:2 codec, then libmpeg2, then others.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2904 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2905 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2906 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2907 .TP
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2908 .B \-vfm <driver1,driver2,...>
9761
878025a8da6c watch what you write
gabucino
parents: 9716
diff changeset
2909 Specify a priority list of video codecs to be used, according to their
878025a8da6c watch what you write
gabucino
parents: 9716
diff changeset
2910 names in codecs.conf.
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2911 It falls back to default if none is OK.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2912 .br
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2913 .I NOTE:
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2914 If libdivxdecore support was compiled in, then odivx and divx4 now contains
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2915 just the same DivX4 codec, but different APIs to reach it.
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2916 For difference between them and when to use which, check the DivX4 section in
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2917 the documentation.
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2918 .br
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2919 See \-vfm help for a full list of available drivers.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
2920 .sp 1
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2921 .I EXAMPLE:
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2922 .PD 0
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2923 .RSs
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2924 .IPs "\-vfm ffmpeg,dshow,vfw"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2925 Try the libavcodec, then Directshow, then VFW codecs and fall back
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2926 to the others, if still none is OK.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2927 .IPs "\-vfm xanim"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
2928 Try XAnim codecs first.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2929 .RE
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2930 .PD 1
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2931 .
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2932 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
2933 .B \-x <x> (MPlayer only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2934 Scale image to x width (if sw/\:hw scaling available).
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
2935 Disables aspect calculations.
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
2936 .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
2937 .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
2938 Specify additional parameters when decoding with XviD.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2939 .
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2940 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2941 .RSs
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2942 .IPs deblock-chroma
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
2943 Activate XviD internal postprocessing filter: chroma deblock filter.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2944 See also \-vf pp, which is faster than XviD's own filter.
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2945 .IPs deblock-luma
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
2946 Activate XviD internal postprocessing filter: luma deblock filter.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2947 See also \-vf pp, which is faster than XviD's own filter.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2948 .IPs dr2\ \
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2949 Activate direct rendering method 2.
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2950 .IPs nodr2
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2951 Deactivate direct rendering method 2.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2952 .IPs filmeffect
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2953 Activate XviD internal film grain effect.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
2954 Adds artificial film grain to the video.
11967
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2955 May increase perceived quality, while lowering true quality.
4f4b81257d19 Adds support for the film grain effect and deblocking filters in xvid
attila
parents: 11966
diff changeset
2956 Also see \-vf noise.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2957 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2958 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2959 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
2960 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2961 .B \-xy <value>
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2962 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2963 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2964 .IPs value<=8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2965 Scale image by factor <value>.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
2966 .IPs value>8
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2967 Set width to value and calculate height to keep correct aspect ratio.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2968 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2969 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2970 .
6310
eda1e909a3bf -stop_xscreensaver option
diego
parents: 6268
diff changeset
2971 .TP
12731
150b7272da1b typos pointed out by Sebastian Kr«£mer <mail@skraemer.de>
diego
parents: 12716
diff changeset
2972 .B \-y <y> (MPlayer only)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2973 Scale image to y height (if sw/\:hw scaling available).
7794
bf0d9d17e23a Documented "j" key, small fixes, rewording, spell checking.
diego
parents: 7786
diff changeset
2974 Disables aspect calculations.
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
2975 .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
2976 .B \-zoom \
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2977 Allow software scaling, where available.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2978 Could be used to force scaling with \-vf scale.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2979 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
2980 .I NOTE:
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
2981 \-vf scale will IGNORE options \-x / \-y / \-xy / \-fs / \-aspect without
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
2982 \-zoom.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2983 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2984 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2985 .SH "VIDEO FILTERS"
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2986 Video filter are plugins that allow you to modify the video stream and its
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2987 properties.
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2988 The syntax is:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2989 .TP
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
2990 .B \-vf <filter1[=parameters],filter2,...>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2991 Setup a chain of video filters.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2992 .TP
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
2993 .B \-vop <...,filter3[=parameters],filter2,filter1> (OBSOLETE)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2994 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
2995 .B reverse
11178
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2996 order.
d5644a03c32e Fixed a few still missed \- and better linebreaks.
wight
parents: 11164
diff changeset
2997 Deprecated in favor of \-vf.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
2998 .PP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
2999 The parameters are optional and if omitted, some of them are set to default
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3000 values.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3001 Use '-1' to keep the default value.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3002 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
3003 from the upper left corner of the bigger image.
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3004 .br
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3005 .I NOTE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3006 To get a full list of available filters, see \-vf help.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3007 .sp 1
11763
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3008 Filters are managed in lists.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3009 There are a few commands to manage the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3010 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3011 .B \-vf-add <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3012 Appends the filters given as arguments to the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3013 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3014 .B \-vf-pre <filter1[,filter2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3015 Prepends the filters given as arguments to the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3016 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3017 .B \-vf-del <index1[,index2,...]>
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3018 Deletes the filters at the given indexes.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3019 Index numbers start at 0, negative numbers address the end of the
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3020 list (-1 is the last).
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3021 .TP
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3022 .B \-vf-clr
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3023 Completely empties the filter list.
053a82066c60 filter list management
diego
parents: 11762
diff changeset
3024 .PP
11816
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3025 With filters that support it, you can access parameters by their name.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3026 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3027 .B \-vf <filter>=help
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3028 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
3029 filter.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3030 .TP
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3031 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3032 Sets a named parameter to the given value.
637af9175b65 Small wording and consistency improvements, named parameters documented.
diego
parents: 11796
diff changeset
3033 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
3034 .PP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3035 Available filters are:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3036 .
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3037 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3038 .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
3039 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
3040 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
3041 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3042 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3043 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3044 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
3045 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3046 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
3047 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3048 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3049 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3050 .B cropdetect[=0\-255]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3051 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
3052 to stdout.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3053 The threshold can be optionally specified from nothing (0) to everything
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3054 (255).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3055 (default: 24)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3056 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3057 .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
3058 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
3059 that takes two parameters.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3060 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3061 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3062 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3063 width and height (default: -1, maximum possible width where boundaries
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3064 are still visible.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3065 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3066 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
3067 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3068 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3069 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3070 .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
3071 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
3072 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
3073 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
3074 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3075 .IPs w,h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3076 expanded width,height (default: original width,height).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3077 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
3078 .sp 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3079 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3080 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3081 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3082 .IP expand=0:-50:0:0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3083 adds a 50 pixel border to the bottom of the picture
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3084 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3085 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3086 .IPs x,y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3087 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
3088 .IPs o
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3089 OSD/subtitle rendering
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3090 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3091 0: disable (default)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3092 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3093 1: enable
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3094 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3095 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3096 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3097 .B flip\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3098 Flips the image upside down.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3099 See also option \-flip.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3100 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3101 .B mirror\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3102 Mirrors the image on the Y axis.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3103 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3104 .B rotate[=<0\-7>]
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3105 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
3106 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
3107 portrait and not landscape.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3108 .TP
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3109 .B scale[=w:h[:interlaced[:chr_drop[:param[:presize]]]]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3110 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3111 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
3112 .RSs
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3113 .IPs w,h\ \
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3114 scaled width/height (default: original width/height)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3115 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3116 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3117 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
3118 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
3119 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3120 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
3121 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3122 -1: original width/\:height
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3123 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3124 -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
3125 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3126 -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
3127 .REss
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3128 .IPs interlaced
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3129 Toggle interlaced scaling.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3130 .IPs chr_drop
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3131 chroma skipping
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3132 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3133 0: use all available input lines for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3134 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3135 1: use only every 2. input line for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3136 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3137 2: use only every 4. input line for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3138 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3139 3: use only every 8. input line for chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3140 .REss
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3141 .IPs param
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3142 scaling parameter (depends upon the scaling method used)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3143 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3144 \-sws 2 (bicubic): sharpness (0 (soft) \- 100 (sharp))
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3145 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3146 \-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
3147 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3148 \-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
3149 .REss
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3150 .IPs presize
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3151 Scale to preset sizes.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3152 .RSss
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3153 qntsc: 352x240 (NTSC quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3154 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3155 qpal: 352x288 (PAL quarter screen)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3156 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3157 ntsc: 720x480 (standard NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3158 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3159 pal: 720x576 (standard PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3160 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3161 sntsc: 640x480 (square pixel NTSC)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3162 .br
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3163 spal: 768x576 (square pixel PAL)
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
3164 .REss
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3165 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3166 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3167 .B dsize={aspect|w:h}
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3168 Changes the intended display size/aspect at an arbitrary point in the
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3169 filter chain.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3170 Aspect can be given as a fraction (4/3) or floating point number
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3171 (1.33).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3172 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
3173 desired.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3174 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
3175 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
3176 correct aspect.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3177 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3178 .B yuy2\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3179 Forces software YV12/\:I420 or 422P to YUY2 conversion.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3180 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3181 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3182 .B yvu9\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3183 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
3184 Deprecated in favor of the software scaler.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3185 .TP
11572
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3186 .B yuvcsp\
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3187 Clamps YUV color values to the CCIR 601 range without doing real conversion.
06761b6056ed -vf yuvcsp
diego
parents: 11560
diff changeset
3188 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3189 .B rgb2bgr[=swap]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3190 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
3191 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3192 .RSs
12559
diego
parents: 12558
diff changeset
3193 .IPs swap\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3194 Also perform R <\-> B swapping.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3195 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3196 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3197 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3198 .B palette
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3199 RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3200 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3201 .B format[=fourcc]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3202 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
3203 Use together with the scale filter for a real conversion.
11313
b4fad475a89d Add -vf format=fmt=help hint.
diego
parents: 11302
diff changeset
3204 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
3205 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3206 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3207 .IPs fourcc
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3208 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
3209 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3210 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3211 .TP
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3212 .B noformat[=fourcc]
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3213 Restricts the colorspace for the next filter without doing any conversion.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3214 Unlike the format filter, this will allow any colorspace
11927
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3215 .B except
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3216 the one you specify.
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3217 For a list of available formats see noformat=fmt=help.
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3218 .PD 0
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3219 .RSs
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3220 .IPs fourcc
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3221 format name like rgb15, bgr24, yv12, etc (default: yv12)
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3222 .RE
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3223 .PD 1
b0d9fd244d10 new filter: vf_noformat.
joey
parents: 11925
diff changeset
3224 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3225 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (see \-pphelp too)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3226 This option enables usage of MPlayer's internal postprocessing filter,
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3227 and also gives an interface where you can pass options to the named filter.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3228 To get a list of available filters, use \-pphelp.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3229 Note that each sub-filter must be separated with a / sign.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3230 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3231 Each filter defaults to 'c' (chrominance).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3232 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3233 The keywords accept a '-' prefix to disable the option.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3234 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3235 A ':' followed by a letter may be appended to the option to indicate its
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3236 scope:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3237 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3238 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3239 .IPs a
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3240 Automatically switches the filter off if the CPU is too slow.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3241 .IPs c
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3242 Do chrominance filtering, too.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3243 .IPs y
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3244 Do not do chrominance filtering (only luminance filtering).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3245 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3246 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3247 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3248 .RS
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3249 .I EXAMPLE:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3250 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3251 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3252 .RSs
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3253 .IPs "\-vf pp=hb/vb/dr/al"
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3254 horizontal and vertical deblocking, deringing and automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3255 brightness/\:contrast
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3256 .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
3257 horizontal and vertical deblocking, deringing, automatic
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3258 brightness/\:contrast and linear blend deinterlacer
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3259 .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
3260 default filters without brightness/\:contrast correction
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3261 .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
3262 Enable default filters & temporal denoiser.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3263 .IPs "\-vf pp=hb:y/vb:a \-autoq 6"
10865
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3264 Deblock horizontal only luminance and switch vertical deblocking on or
308c20281eec Fixed 2 bugs spotted by Nico + extended a description, spelling cosmetics.
diego
parents: 10813
diff changeset
3265 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
3266 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3267 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3268 .TP
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3269 .B spp[=quality[:qp[:mode]]]
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3270 simple postprocessing filter
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3271 .RSs
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3272 .IPs quality
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3273 0\-6 (default: 3)
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3274 .IPs qp\ \ \
11993
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3275 force quantization parameter (default: 0, use qp from video)
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3276 .IPs mode\ \ \
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3277 0: hard thresholding (default)
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3278 .br
4e2d99dbef78 spp soft thresholding patch by (James Crowson <jbcrowso at ncsu dot edu>)
michael
parents: 11992
diff changeset
3279 1: soft thresholding (better deringing, but blurrier)
11279
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3280 .RE
46067d1a28aa -vf spp
michael
parents: 11271
diff changeset
3281 .TP
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
3282 .B qp=equation
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3283 qp change filter
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3284 .RSs
11925
003959ebfcd7 Expand frame dropping state description, qp filter explanation improved.
diego
parents: 11921
diff changeset
3285 .IPs equation
11921
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3286 some equation like "2+2*sin(PI*qp)"
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3287 .RE
dd3ac91a86b5 qp change filter
michael
parents: 11919
diff changeset
3288 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3289 .B test\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3290 Generate various test patterns.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3291 .TP
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3292 .B rgbtest
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3293 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
3294 You should see a red, green and blue stripe from top to bottom.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3295 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3296 .B lavc[=quality:fps]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3297 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
3298 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
3299 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3300 .IPs quality
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3301 .RSss
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3302 1\-31: fixed qscale
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3303 .br
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3304 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
3305 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3306 .IPs fps\ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3307 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
3308 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3309 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3310 .B fame\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3311 Fast software YV12 to MPEG1 conversion with libfame for use with DVB/\:DXR3.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3312 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3313 .B dvbscale[=aspect]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3314 Set up optimal scaling for DVB cards, scaling the X axis in hardware and
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3315 calculating the Y axis scaling in software to keep aspect.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3316 It's only useful together with expand+scale
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3317 (\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc).
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3318 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3319 .IPs aspect
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
3320 Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3321 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3322 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3323 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3324 .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
3325 Adds noise.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3326 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3327 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3328 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3329 luma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3330 .IPs <0\-100>
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3331 chroma noise
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3332 .IPs u
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3333 uniform noise (gaussian otherwise)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3334 .IPs t
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3335 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
3336 .IPs a
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3337 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
3338 .IPs h
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3339 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
3340 .IPs p
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3341 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
3342 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3343 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3344 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3345 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3346 .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
3347 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
3348 images really still (This should enhance compressibility.).
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3349 It can be given from 0 to 3 parameters.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3350 If you omit a parameter, a reasonable value will be inferred.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3351 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3352 .RSs
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3353 .IPs luma\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3354 spatial luma strength (default = 4)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3355 .IPs chroma
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3356 spatial chroma strength (default = 3)
11733
7f596e8eed2d small fixes
diego
parents: 11708
diff changeset
3357 .IPs time\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3358 temporal strength (default = 6)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3359 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3360 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3361 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3362 .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
3363 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
3364 Parameters and usage are the same.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3365 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3366 .B eq[=bright:cont]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3367 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
3368 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
3369 contrast controls in hardware.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3370 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
3371 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
3372 with lower bitrates.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3373 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
3374 .TP
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
3375 .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
3376 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
3377 allowing gamma correction in addition to simple brightness
c934dadd77c2 -vf eq only supports brightness and contrast, noticed by Torinthiel.
diego
parents: 11095
diff changeset
3378 and contrast adjustment.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3379 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
3380 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
3381 The parameters are given as floating point values.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3382 Parameters rg, gg, bg are the independent gamma values for the Red, Green
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3383 and Blue components.
11391
d83dedaff4d4 eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)
michael
parents: 11382
diff changeset
3384 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
3385 bright image areas, e.g.\& keep them from getting overamplified and just plain
11609
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
3386 white.
59045fb3fb2d small fixes
wight
parents: 11603
diff changeset
3387 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
3388 at its full strength.
11424
d2b9ef48f2b7 no more than 79 chars per line in man page
nicolas
parents: 11411
diff changeset
3389 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
3390 weight=1.0.
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
3391 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
3392 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
3393 weight.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3394 .TP
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3395 .B hue[=hue:saturation]
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3396 Defaults are hue=0.0, saturation=1.0.
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3397 Value ranges are -180\-180 for hue, -2\-2 for saturation (negative values result
11302
dc4db88fc4ff -nocolorkey readded.
diego
parents: 11293
diff changeset
3398 in a negative chroma).
11285
e8d032162e3c -vf hue
michael
parents: 11282
diff changeset
3399 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3400 .B halfpack[=f]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3401 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
3402 keeping all chroma samples.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3403 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
3404 is poor quality or is not available.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3405 Can also be used as a primitive luma-only deinterlacer with very low cpu
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3406 usage.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3407 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
3408 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
3409 odd lines.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3410 Any other value for f gives the default (averaging) behavior.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3411 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
3412 .B ilpack[=mode]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3413 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
3414 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
3415 the chroma channels.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3416 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
3417 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
3418 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
3419 The optional argument selects the sampling mode.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
3420 By default, linear interpolation (mode 1) is used.
2e6fc0ab578f document new mode argument for ilpack
rfelker
parents: 11609
diff changeset
3421 Mode 0 uses nearest-neighbor sampling, which is fast but incorrect.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3422 .TP
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3423 .B harddup
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3424 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3425 If harddup is used when encoding, it will force duplicate frames to be
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3426 encoded in the output.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3427 This uses slightly more space, but is necessary for output to MPEG
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3428 files or if you plan to demux and remux the video stream after
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3429 encoding.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3430 Should be placed at or near the end of the filter chain unless you
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3431 have a good reason to do otherwise.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3432 .TP
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3433 .B softskip
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3434 Only useful with MEncoder.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3435 Softskip moves the frame skipping (dropping) step of encoding from
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3436 before the filter chain to some point during the filter chain.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3437 This allows filters which need to see all frames (inverse telecine,
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3438 temporal denoising, etc.) to function properly.
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3439 Should be placed after the filters which need to see all frames and
12559
diego
parents: 12558
diff changeset
3440 before any subsequent filters that are CPU-intensive.
12338
d313869f6b31 document harddup and softskip
rfelker
parents: 12330
diff changeset
3441 .TP
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3442 .B decimate[=max:hi:lo:frac]
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3443 Drops frames that don't differ greatly from the previous frame in
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3444 order to reduce framerate.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3445 The argument max (if positive) sets the maximum number of consecutive
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3446 frames which can be dropped, or (if negative) the minimum interval
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3447 between dropped frames.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3448 A frame is a candidate for dropping if no 8x8 region differs by more
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3449 than a threshold of hi, and if not more than frac portion (1 meaning
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3450 the whole image) differs by more than a threshold of lo.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3451 Values of hi and lo are for 8x8 pixel blocks and represent actual
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3452 pixel value differences, so a threshold of 64 corresponds to 1 unit of
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3453 difference for each pixel, or the same spread out differently over the
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3454 block.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3455 The main use of this filter is for very-low-bitrate encoding (e.g.\&
10279
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3456 streaming over dialup modem), but it could in theory be used for
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3457 fixing movies that were inverse-telecined incorrectly.
e79162f48087 document vf_decimate
rfelker
parents: 10227
diff changeset
3458 .TP
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3459 .B dint[=sense:level]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3460 Detects and drops first of interlaced frames in video stream.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3461 Values can be from 0.0 to 1.0 \- first (default 0.1) is relative difference
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3462 between neighbor pixels, second (default 0.15) is what part of image have to
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3463 be detected as interlaced to drop the frame.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3464 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3465 .B lavcdeint
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3466 Use libavcodec's deinterlace filter.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3467 .TP
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
3468 .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
3469 Donald Graft's adaptive kernel deinterlacer.
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3470 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
3471 .PD 0
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3472 .RSs
11991
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
3473 .IPs "thresh (0 - 255)"
1c268fb0503d A bit late, but here's the "more sane options ordering" patch.
ranma
parents: 11981
diff changeset
3474 Threshold (default 10).
11904
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3475 .IPs "map (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3476 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
3477 .IPs "order (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3478 Swap fields if 1 (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3479 .IPs "sharp (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3480 Enable additional sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3481 .IPs "twoway (0 or 1)"
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3482 Enable twoway sharpening (default: 0).
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3483 .RE
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3484 .PD 1
7fd3f926a294 rgbtest filter added, kerndeint filter description fixed and moved to a
diego
parents: 11903
diff changeset
3485 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3486 .B unsharp=l|cWxH:amount[:l|cWxH:amount]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3487 Unsharp mask / gaussian blur.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3488 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3489 .IPs l
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3490 Apply effect on luma component.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3491 .IPs c
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3492 Apply effect on chroma components.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3493 .IPs WxH
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3494 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
3495 (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
3496 .IPs amount
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3497 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
3498 (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
3499 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3500 <0: blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3501 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3502 >0: sharpen
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3503 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3504 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3505 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3506 .B swapuv\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3507 Swap U & V plane.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3508 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3509 .B il=[d|i][s][:[d|i][s]]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3510 (de)interleaves lines.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3511 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
3512 pre-field without deinterlacing them.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3513 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
3514 interlacing.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3515 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
3516 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
3517 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
3518 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
3519 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3520 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3521 .IPs d
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3522 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
3523 .IPs i
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3524 interleave
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3525 .IPs s
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3526 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
3527 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3528 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3529 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3530 .B fil=[i|d]
11251
731652167590 -vf fil
michael
parents: 11247
diff changeset
3531 (de)interleaves lines.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3532 This filter is very similar to the il filter but much faster, the main
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3533 disadvantage is that it doesn't always work.
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3534 Especially if combined with other filters it may produce randomly messed
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3535 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
3536 your combination of filters.
11286
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3537 .PD 0
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3538 .RSs
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3539 .IPs d
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3540 Deinterleave fields, placing them side by side.
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3541 .IPs i
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3542 Interleave fields again (reversing the effect of fil=d).
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3543 .RE
d5f8358ab487 Torinthiel: -nocolorkey removed (-colorkey present), \ missing,
diego
parents: 11285
diff changeset
3544 .PD 1
11251
731652167590 -vf fil
michael
parents: 11247
diff changeset
3545 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3546 .B field[=n]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3547 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
3548 to avoid wasting CPU time.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3549 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
3550 field (depending on whether n is even or odd).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3551 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3552 .B detc[=var1=value2:var2=value2:...]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3553 Attempts to reverse the 'telecine' process to recover a clean,
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3554 non-interlaced stream at film framerate.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3555 This was the first and most primitive inverse telecine filter to be
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3556 added to MPlayer/MEncoder.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3557 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
3558 long as possible.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3559 This makes it suitable for perfectly-telecined material, even in the
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3560 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
3561 of complex post-telecine edits.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3562 Development on this filter is no longer taking place, as ivtc, pullup,
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3563 and filmdint are better for most applications.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3564 The following arguments (see syntax above) may be used to control
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3565 detc's behavior:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3566 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3567 .IPs dr
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3568 Set the frame dropping mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3569 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
3570 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
3571 merges in the past 5 frames.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3572 2 means always maintain exact 5:4 input to output frame ratio.
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3573 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3574 Use mode 1 or 2 with MEncoder.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3575 .IPs am
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3576 Analysis mode.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3577 Available values are 0 (fixed pattern with initial frame number
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3578 specified by fr=#) and 1 (agressive search for telecine pattern).
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3579 Default is 1.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3580 .IPs fr
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3581 Set initial frame number in sequence.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3582 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
3583 interlaced frames.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3584 The default, -1, means 'not in telecine sequence'.
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3585 The number specified here is the type for the imaginary previous
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3586 frame before the movie starts.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3587 .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
3588 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
3589 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3590 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3591 .B ivtc[=1]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3592 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
3593 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
3594 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
3595 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
3596 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
3597 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
3598 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
3599 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
3600 As with detc, you must specify the correct output framerate (\-ofps
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
3601 23.976) when using MEncoder.
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3602 Further development on ivtc has stopped, as the pullup and filmdint
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3603 filters appear to be much more accurate.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3604 .TP
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3605 .B pullup[=jl:jr:jt:jb:sb]\
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3606 Third-generation pulldown reversal (inverse telecine) filter,
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3607 capable of handling mixed hard-telecine, 24 fps progressive, and 30
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3608 fps progressive content.
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3609 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
3610 ivtc, by taking advantage of future context in making its decisions.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3611 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
3612 a pattern to follow, but it instead looks forward to the following
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3613 fields in order to identify matches and rebuild progressive frames.
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3614 It is still under development, but believed to be quite accurate.
12549
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3615 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
3616 the left, right, top, and bottom of the image, respectively.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3617 Left/right are in units of 8 pixels, while top/bottom are in units of
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3618 2 lines.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3619 The default is 8 pixels on each side.
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3620 Setting the sb (strict breaks) option to 1 will reduce the chances of
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3621 pullup generating an occasional mismatched frame, but it may also
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3622 cause an excessive number of frames to be dropped during high motion
bb9bf9a97ac6 configurable 'junk' borders for pullup
rfelker
parents: 12544
diff changeset
3623 sequences.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
3624 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
3625 .I NOTE:
12339
0e016f036116 updated documentation for detc,ivtc,pullup
rfelker
parents: 12338
diff changeset
3626 Always follow pullup with the softskip filter when encoding to ensure
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3627 that pullup is able to see each frame.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3628 Failure to do so will lead to incorrect output and will usually crash,
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3629 due to design limitations in the codec/filter layer.
10665
f420036041fb document vf_pullup (vaguely at least)
rfelker
parents: 10644
diff changeset
3630 .TP
11600
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3631 .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
3632 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
3633 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
3634 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
3635 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
3636 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
3637 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
3638 approximation.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
3639 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
3640 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
3641 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
3642 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
3643 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
3644 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
3645 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
3646 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
3647 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
3648 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
3649 .RSs
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3650 .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
3651 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
3652 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
3653 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
3654 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
3655 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
3656 .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
3657 For each ifps input frames the filter will output ofps frames.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3658 The ratio of ifps/ofps should match the \-fps/\-ofps ratio.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3659 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
3660 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
3661 .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
3662 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
3663 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
3664 fields.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3665 .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
3666 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
3667 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
3668 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
3669 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
3670 .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
3671 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
3672 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
3673 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
3674 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
3675 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
3676 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
3677 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
3678 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
3679 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
3680 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
3681 much accuracy.
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
3682 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
3683 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
3684 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
3685 .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
3686 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
3687 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
3688 .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
3689 Deinterlace threshold.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3690 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
3691 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
3692 deinterlacing.
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3693 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
3694 .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
3695 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
3696 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
3697 .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
3698 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
3699 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
3700 .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
3701 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
3702 .RE
5eb66d37d539 Yet another inverse telecine filter by Zoltan Hidvegi <mplayer@hzoli.2y.net>. Also heavily MMX centric.
alex
parents: 11598
diff changeset
3703 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3704 .B softpulldown
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
3705 This filter works only correct with MEncoder and acts on the MPEG2 flags
10523
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
3706 used for soft 3:2 pulldown (soft telecine).
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
3707 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
3708 telecined, inserting this filter before them should make them more reliable.
f417d3d8aa4d Document softpulldown filter.
ranma
parents: 10503
diff changeset
3709 .TP
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3710 .B divtc[=options]
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3711 Inverse telecine for deinterlaced video.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3712 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
3713 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
3714 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
3715 This filter is intended to find and drop those duplicates and restore the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3716 original film framerate.
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3717 When using this filter, you must specify \-ofps that is 4/5 of the fps of the
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3718 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
3719 The options are:
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3720 .RSs
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3721 .IPs pass=1|2
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3722 Use two-pass mode.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3723 This produces best results.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3724 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
3725 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
3726 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
3727 process.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3728 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
3729 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
3730 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
3731 .IPs file=filename
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3732 Set the 2-pass log file name (default: "framediff.log").
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3733 .IPs threshold=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3734 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
3735 believe in it (default: 0.5).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3736 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
3737 that are very dark or very still.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3738 .IPs window=numframes
12225
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3739 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
3740 (default: 30).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3741 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
3742 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
3743 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
3744 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
3745 and past.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3746 .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
3747 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
3748 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
3749 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
3750 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
3751 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
3752 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
3753 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
3754 .IPs deghost=value
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3755 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
3756 mode, default 0).
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3757 If nonzero, deghosting mode is used.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3758 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
3759 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
3760 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
3761 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
3762 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
3763 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
3764 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
3765 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
3766 absolute value of the parameter.
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3767 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
3768 .RE
eb79a6192b2b New filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12221
diff changeset
3769 .TP
12081
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3770 .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
3771 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
3772 changes.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3773 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
3774 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
3775 The options are:
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3776 .RSs
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3777 .IPs t
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3778 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
3779 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
3780 .IPs b
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3781 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
3782 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
3783 .IPs p
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3784 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
3785 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
3786 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
3787 .IPs a
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3788 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
3789 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
3790 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
3791 .IPs u
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3792 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
3793 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
3794 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
3795 fields.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3796 .IPs T
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3797 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
3798 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
3799 .IPs B
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3800 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
3801 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
3802 .IPs A
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3803 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
3804 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
3805 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
3806 This is the default mode.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3807 .IPs U
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3808 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
3809 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
3810 .IPs v
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3811 Verbose operation.
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3812 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
3813 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
3814 .RE
e34700c872ac vf_phase filter by Ville Saari (114263 at foo dot bar dot org)
rfelker
parents: 12061
diff changeset
3815 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3816 .B telecine[=start]
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3817 Apply 3:2 'telecine' process to increase framerate by 20%.
10524
3eeb6cdddea1 spelling corrections
diego
parents: 10523
diff changeset
3818 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
3819 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
3820 Both fps options are essential!
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3821 (A/V sync will break if they are wrong.)
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3822 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
3823 pattern to start (0\-3).
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3824 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3825 .B tinterlace[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3826 Temporal field interlacing \- merge pairs of frames into an interlaced
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3827 frame, halving the framerate.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3828 Even frames are moved into the upper field, odd frames to the lower field.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
3829 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
3830 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
3831 .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
3832 .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
3833 .IPs 0
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3834 odd frames into upper field, even to lower, generating a full-height
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3835 frame at half the framerate
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3836 .IPs 1
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3837 only output odd frames, even frames are dropped, height unchanged
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3838 .IPs 2
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3839 only output even frames, odd frames are dropped, height unchanged
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3840 .IPs 3
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3841 expand each frame to full height, but pad alternate lines with black,
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3842 framerate unchanged
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3843 .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
3844 .PD 1
07cfe1e1a2c9 'tinterlace' filter (partial inverse of tfields) by Not Zed <notzed@ximian.com> (with minor fixes for current cvs by me)
alex
parents: 10537
diff changeset
3845 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3846 .B tfields[=mode]
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3847 Temporal field separation \- split fields into frames, doubling the
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3848 output framerate.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3849 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
3850 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
3851 desired (double) framerate!
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
3852 Available modes are:
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3853 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3854 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3855 .IPs 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3856 leave fields unchanged (this will jump/flicker)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3857 .IPs 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3858 interpolate missing lines (the algorithm used might not be so good)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3859 .IPs 2
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3860 translate fields by 1/4 pixel with linear interp (no jump)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3861 .IPs 4
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3862 translate fields by 1/4 pixel with 4tap filter (higher quality)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3863 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3864 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3865 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3866 .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
3867 box blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3868 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3869 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3870 .IPs radius
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3871 size of the filter
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3872 .IPs power
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3873 How often the filter should be applied.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3874 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3875 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3876 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3877 .B sab=rad:pf:colorDiff[:rad:pf:colorDiff]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3878 shape adaptive blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3879 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3880 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3881 .IPs rad\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3882 blur filter strength (~0.1\-4.0) (slower if larger)
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3883 .IPs pf\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3884 prefilter strength (~0.1\-2.0)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3885 .IPs colorDiff
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3886 How different the pixels are allowed to be considered.
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3887 (~0.1\-100.0)
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3888 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3889 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3890 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3891 .B smartblur=rad:strength:thresh[:rad:strength:thresh]
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3892 smart blur
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3893 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3894 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3895 .IPs rad\ \
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3896 blur filter strength (~0.1\-5.0) (slower if larger)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3897 .IPs strength
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3898 blur (0.0\-1.0) or sharpen (-1.0\-0.0)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3899 .IPs thresh
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3900 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
3901 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3902 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3903 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3904 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3905 perspective correction
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3906 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3907 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3908 .IPs x0,y0,...
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3909 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
3910 .IPs t\ \ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3911 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
3912 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3913 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3914 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3915 .B 2xsai\ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3916 Use the 2x scale and interpolate algorithm for scaling and smoothing images.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3917 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3918 .B 1bpp\ \ \
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3919 1bpp bitmap to YUV/BGR 8/15/16/32 conversion
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3920 .TP
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3921 .B down3dright[=lines]
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3922 Reposition and resize stereoscopic images.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3923 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
3924 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
3925 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3926 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3927 .IPs lines
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3928 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
3929 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3930 .PD 1
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3931 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
3932 .B bmovl=hidden:opaque:<fifo>
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3933 Read bitmaps from a FIFO and display them in a window.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3934 .
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3935 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3936 .RSs
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3937 .IPs hidden
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3938 sets the default value of the 'hidden' flag (boolean)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3939 .IPs opaque
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3940 flag switching between alphablended (transparent) and opaque (fast) mode
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3941 .IPs fifo\
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
3942 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
3943 controlling application)
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3944 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3945 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3946 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3947 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3948 FIFO commands are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3949 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3950 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3951 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3952 .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
3953 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
3954 .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
3955 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
3956 .IPs "RGB24 width height xpos ypos alpha clear"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3957 followed by width*height*3 Bytes of raw RGB32 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3958 .IPs "BGR24 width height xpos ypos alpha clear"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3959 followed by width*height*3 Bytes of raw BGR32 data.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3960 .IPs "ALPHA width height xpos ypos alpha"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3961 change alpha for area
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3962 .IPs "CLEAR width height xpos ypos"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3963 clear area
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3964 .IPs OPAQUE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3965 disable all alpha transparency.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3966 Send "ALPHA 0 0 0 0 0" to enable it again.
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3967 .IPs HIDE\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3968 hide bitmap
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
3969 .IPs SHOW\
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3970 show bitmap
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3971 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3972 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
3973 .sp 1
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3974 .RS
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3975 Arguments are:
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3976 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3977 .PD 0
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3978 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3979 .IPs "width, height"
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3980 size of image/area
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
3981 .IPs "xpos, ypos"
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
3982 start blitting at X/Y position
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3983 .IPs alpha
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
3984 Set alpha difference.
10218
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3985 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
3986 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
3987 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3988 0: same as original
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3989 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3990 255: makes everything opaque
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3991 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3992 -255: makes everything transparent
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3993 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3994 .IPs clear
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3995 clear the framebuffer before blitting.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3996 .RSss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3997 0: The image will just be blitted on top of the old one, so you don't need to
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3998 send 1,8MB of RGBA32 data everytime a small part of the screen is updated.
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
3999 .br
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4000 1: clear
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4001 .REss
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4002 .RE
f82646fc1431 Moved video filters to a separate section, moved slave mode section to the
jonas
parents: 10091
diff changeset
4003 .PD 1
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4004 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4005 .B framestep=I|[i]step
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4006 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
4007 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4008 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
4009 keyframes are rendered.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4010 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
4011 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
4012 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
4013 .sp 1
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
4014 When a keyframe is found, an 'I!' string followed by a newline character is
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4015 printed, leaving the current line of mplayer/mencoder output on the screen,
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4016 because it contains the time (in seconds) and frame number of the keyframe
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4017 (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
4018 .sp 1
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4019 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
4020 every 'step' frames is rendered.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4021 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4022 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
4023 (like the I parameter).
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4024 .sp 1
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4025 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
4026 printed.
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4027 .TP
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4028 .B tile=xtile:ytile:output:start:delta
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4029 Tile a series of images into a single, bigger image.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4030 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
4031 value is used.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4032 You can also stop when you're OK (... \-vf tile=10:5 ...).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4033 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4034 It is probably a good idea to put the scale filter before the tile :-)
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4035 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4036 The parameters are:
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4037 .sp 1
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4038 .PD 0
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4039 .RSs
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4040 .IPs xtile
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4041 number of tiles on the x axis (default: 5)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4042 .IPs ytile
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4043 number of tiles on the y axis (default: 5)
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4044 .IPs output
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4045 Render the tile when 'output' number of frames are reached, where 'output'
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4046 should be a number less than xtile * ytile.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4047 Missing tiles are left blank.
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4048 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
4049 image every 2 seconds @ 25 fps.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4050 .IPs start
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4051 pixel at the start (x/y) (default: 2)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4052 .IPs delta
10769
95b683f890db framestep and tile filters clarified.
diego
parents: 10761
diff changeset
4053 pixel between 2 tiles, (x/y) (default: 4)
10748
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4054 .RE
06dc8d890dde vf_tile & _framestep added
arpi
parents: 10731
diff changeset
4055 .PD 1
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4056 .TP
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4057 .B delogo[=x:y:w:h:t]
10813
f646e30ba119 spelling/wording fixes
diego
parents: 10812
diff changeset
4058 Suppresses a TV station logo by a simple interpolation of the
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4059 surrounding pixels.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4060 Just set a rectangle covering the logo and watch it disappear (and
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4061 sometimes something even uglier appear \- your mileage may vary).
10812
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4062 .PD 0
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4063 .RSs
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4064 .IPs x,y
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4065 Position of the top left corner of the logo.
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4066 .IPs w,h
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4067 Width and height of the cleared rectangle.
f028201f6019 delogo filter
henry
parents: 10784
diff changeset
4068 .IPs t
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4069 Thickness of the fuzzy edge of the rectangle (added to w and h).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4070 When set to -1, a green rectangle is drawn on the screen to
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4071 simplify finding the right x,y,w,h parameters.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4072 .RE
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4073 .PD 1
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4074 .TP
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4075 .B zrmjpeg[=options]
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4076 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
4077 output device.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4078 .RSs
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4079 .IPs maxheight=h|maxwidth=w
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4080 These options set the maximum width and height the zr card
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4081 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
4082 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4083 Use these options to set maxwidth and maxheight automatically to the
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4084 values known for card/mode combo.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4085 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
4086 .IPs color|bw
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4087 Select color or black and white encoding.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4088 Black and white encoding is faster.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4089 Color is the default.
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4090 .IPs hdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4091 Horizontal decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4092 .IPs vdec={1,2,4}
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4093 Vertical decimation 1, 2 or 4.
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4094 .IPs quality=1-20
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4095 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
4096 .IPs fd|nofd
12028
91eb4f10a9ad spelling fixes
diego
parents: 12016
diff changeset
4097 By default, decimation is only performed if the Zoran hardware
11762
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4098 can upscale the resulting MJPEG images to the original size.
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4099 The option fd instructs the filter to always perform the requested
1bf46f3edcb3 misc fixes
diego
parents: 11759
diff changeset
4100 decimation (ugly).
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
4101 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4102 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4103 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4104 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4105 .TP
11454
gabucino
parents: 11448
diff changeset
4106 .B \-audio-delay <0.0\-...>
gabucino
parents: 11448
diff changeset
4107 Sets the audio delay field in the header.
gabucino
parents: 11448
diff changeset
4108 Default is 0.0, negative values do not work.
gabucino
parents: 11448
diff changeset
4109 This does not delay the audio while encoding, but the player will see the
gabucino
parents: 11448
diff changeset
4110 default audio delay, sparing you the use of the \-delay option.
gabucino
parents: 11448
diff changeset
4111 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4112 .B \-audio-density <1\-50>
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4113 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
4114 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4115 .I NOTE:
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4116 CBR only, VBR ignores this as it puts each packet in a new chunk.
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4117 .TP
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4118 .B \-audio-preload <0.0\-2.0>
6867
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4119 Sets up audio buffering time interval (default: 0.5s).
c80534f06cf5 Documented -srate for MEncoder.
diego
parents: 6849
diff changeset
4120 .TP
8356
02e30a70053f more precise definition of -endpos
arpi
parents: 8265
diff changeset
4121 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too)
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4122 Stop encoding at given time or byte position.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4123 Can be specified in many ways:
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4124 .br
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4125 .I NOTE:
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4126 Byte position won't be accurate, as it can only stop at
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4127 a frame boundary.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4128 .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
4129 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4130 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4131 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4132 .IPs "\-endpos 56"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4133 encode only 56 seconds
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4134 .IPs "\-endpos 01:10:00"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4135 encode only 1 hour 10 minutes
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4136 .IPs "\-endpos 100mb"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4137 encode only 100 MBytes
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4138 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4139 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4140 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4141 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4142 .B \-ffourcc <fourcc>
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4143 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
4144 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4145 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4146 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4147 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4148 .IPs "\-ffourcc div3"
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4149 will have the output file contain 'div3' as video fourcc.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4150 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4151 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4152 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4153 .TP
12061
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4154 .B \-force-avi-aspect <0.2\-3.0>
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4155 Override the aspect stored in the AVI OpenDML vprp header.
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4156 This can be used to change the aspect ratio with \-ovc copy.
656a1b45b309 Use aspect from encoder for AVI vprp header
ranma
parents: 12054
diff changeset
4157 .TP
9769
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4158 .B \-info <option1:option2:...> (AVI only)
1e0082188467 fixing explanation
gabucino
parents: 9761
diff changeset
4159 Specify the info header of the resulting AVI file.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4160 .br
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4161 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
4162 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4163 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4164 .IPs help\
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4165 show this description
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4166 .IPs name=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4167 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
4168 .IPs artist=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4169 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
4170 .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
4171 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
4172 .IPs subject=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4173 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
4174 .IPs copyright=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4175 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
4176 .IPs srcform=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4177 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
4178 .IPs comment=<value>
12406
e946216a94ad spelling, wording sync with cfg-mencoder.h
diego
parents: 12402
diff changeset
4179 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
4180 .RE
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4181 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4182 .TP
10731
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4183 .B \-noautoexpand
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4184 Do not automatically insert the expand filter into the MEncoder filter chain.
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4185 Useful to control at which point of the filter chain subtitles are rendered
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4186 when hardcoding subtitles onto a movie.
8dcd70e68658 -noautoexpand documented.
diego
parents: 10729
diff changeset
4187 .TP
12366
b6ff3941519b standard notation
diego
parents: 12363
diff changeset
4188 .B \-noodml (\-of avi only)
12363
5dac21977312 Allow user to disable writing of ODML index
ranma
parents: 12339
diff changeset
4189 Do not write OpenDML index for files >1GB.
5dac21977312 Allow user to disable writing of ODML index
ranma
parents: 12339
diff changeset
4190 .TP
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4191 .B \-noskip
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4192 Do not skip frames.
6022
63d320c955c1 noskip to mencoder only opts, endpos understands byte position too and small changes
jonas
parents: 6005
diff changeset
4193 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4194 .B \-o <filename>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4195 Outputs to the given filename, instead of the default 'test.avi'.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4196 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4197 .B \-oac <codec name>
8762
75d22ee5f975 Per-file configuration, typos, rewordings, consistency and a 10l .In.
diego
parents: 8745
diff changeset
4198 Encode with the given audio codec.
9644
0fe056bdb135 vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
jonas
parents: 9643
diff changeset
4199 Use \-oac help to get a list of available codecs.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4200 (no default set)
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4201 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4202 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4203 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4204 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4205 .IPs "\-oac copy"
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4206 no encoding, just streamcopy
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4207 .IPs "\-oac pcm"
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4208 encode to uncompressed PCM
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4209 .IPs "\-oac mp3lame"
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4210 encode to MP3 (using Lame)
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4211 .IPs "\-oac lavc"
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4212 encode with a libavcodec codec
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4213 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4214 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4215 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4216 .TP
8685
a90839057e15 -of is beta code
jonas
parents: 8682
diff changeset
4217 .B \-of <format> (BETA CODE!)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4218 Encode to the specified format.
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4219 Use \-of help to get a list of available formats.
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4220 .sp 1
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4221 .I EXAMPLE:
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4222 .PD 0
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4223 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4224 .IPs "\-of avi"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4225 Encode to AVI (default).
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4226 .IPs "\-of mpeg"
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4227 Encode to MPEG.
12016
b962aaad2940 rawvideo muxer patch by John Earl <jwe21@cam.ac.uk>
ranma
parents: 12013
diff changeset
4228 .IPs "\-of rawvideo"
b962aaad2940 rawvideo muxer patch by John Earl <jwe21@cam.ac.uk>
ranma
parents: 12013
diff changeset
4229 raw video stream (no muxing - video only, one stream only)
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4230 .RE
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4231 .PD 1
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4232 .
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4233 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4234 .B \-ofps <fps>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4235 The output file will have different frame/\:sec than the source.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4236 You MUST set it 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
4237 (29.97fps telecined MPEG) files.
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4238 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4239 .B \-ovc <codec name>
8610
097188da10d3 I got colas ready, new options, fixes and a few cosmetics I forgot to remove...
jonas
parents: 8601
diff changeset
4240 Encode with the given video codec.
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4241 Use \-ovc help to get a list of available codecs.
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4242 (no default set)
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4243 .sp 1
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
4244 .I EXAMPLE:
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4245 .PD 0
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4246 .RSs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4247 .IPs "\-ovc copy"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4248 no encoding, just streamcopy
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4249 .IPs "\-ovc divx4"
8082
d630c877c05c 1) "-ovc divx4" doesn't encode using XViD anymore
rguyom
parents: 8035
diff changeset
4250 encode to DivX4/\:DivX5
11966
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
4251 .IPs "\-ovc raw"
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
4252 encode to arbitrary uncompressed format (use \-vf format to select)
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4253 .IPs "\-ovc lavc"
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4254 encode with a libavcodec codecs
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4255 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4256 .PD 1
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
4257 .
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4258 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4259 .B \-passlogfile <filename>
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4260 When encoding in 2pass mode, MEncoder dumps first pass' informations
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4261 to the given file instead of the default divx2pass.log.
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4262 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4263 .B \-skiplimit <value>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4264 Maximum skippable frames after non-skipped one
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4265 (\-noskiplimit for unlimited number).
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
4266 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4267 .B \-vobsubout <basename>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4268 Specify the basename for the output .idx and .sub files.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4269 This turns off subtitle rendering in the encoded movie and diverts it to
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12607
diff changeset
4270 VOBsub subtitle files.
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4271 .TP
10384
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4272 .B \-vobsuboutid <langid>
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4273 Specify the language two letter code for the subtitles.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4274 This overrides what is read from the DVD or the .ifo file.
2623d03b98e5 Sort options alphabetically.
diego
parents: 10383
diff changeset
4275 .TP
6712
70aa7a20b9c0 Document -vobsubout, -vobsuboutid and -vobsuboutindex
kmkaplan
parents: 6573
diff changeset
4276 .B \-vobsuboutindex <index>
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4277 Specify the index of the subtitles in the output files.
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
4278 (default: 0)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4279 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4280 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4281 .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
4282 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
4283 syntax:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4284 .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
4285 .B \-<codec>opts <option1[=value],option2,...>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4286 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4287 .br
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4288 .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
4289 Where <codec> may be: lavc, xvidenc, divx4, lame
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4290 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4291 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4292 .SS divx4 (\-divx4opts)
12052
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
4293 DivX4 is obsolete and only supported for completeness.
69cf59bb739d -aviaspect option moved to its alphabetical position, new sentences should
diego
parents: 12051
diff changeset
4294 For details about DivX4 options, read the source, most options are not
11197
836228630d1d (C) MPlayer Team
diego
parents: 11186
diff changeset
4295 described here.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4296 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4297 .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
4298 get help
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4299 .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
4300 .B br=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4301 specify bitrate
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4302 .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
4303 .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
4304 (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
4305 .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
4306 (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
4307 .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
4308 .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
4309 .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
4310 maximum keyframe interval (in frames)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4311 .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
4312 .B deinterlace
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4313 enable deinterlacing (avoid it, DivX4 is buggy)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4314 .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
4315 .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
4316 quality (1\-fastest, 5\-best)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4317 .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
4318 .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
4319 minimum 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
4320 .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
4321 .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
4322 maximum 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
4323 .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
4324 .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
4325 rate control period
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4326 .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
4327 .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
4328 rate control reaction period
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4329 .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
4330 .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
4331 rate control reaction ratio
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4332 .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
4333 .B crispness=<0\-100>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4334 specify crispness/\:smoothness
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4335 .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
4336 .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
4337 With this you can encode 2pass DivX4 files.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4338 First encode with pass=1, then with the same parameters, encode with
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4339 pass=2.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4340 .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
4341 .B vbrpass=<0\-2>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4342 Override the pass argument and use XviD VBR Library instead of DivX4 VBR.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4343 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
4344 .
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
4345 .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
4346 .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
4347 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
4348 .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
4349 Analysis (first) 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
4350 The resulting AVI file can be directed to /dev/null.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4351 .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
4352 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
4353 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4354 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4355 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4356 .SS lame (\-lameopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4357 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4358 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4359 .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
4360 get help
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4361 .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
4362 .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
4363 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
4364 .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
4365 .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
4366 .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
4367 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
4368 .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
4369 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
4370 .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
4371 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
4372 .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
4373 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
4374 .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
4375 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
4376 .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
4377 .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
4378 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4379 .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
4380 average bitrate
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4381 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4382 .B cbr\ \ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4383 constant bitrate.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4384 .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
4385 Forces also CBR mode encoding on subsequent ABR presets modes
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4386 .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
4387 .B br=<0\-1024>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4388 specify bitrate in kBit (CBR and ABR 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
4389 .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
4390 .B q=<0\-9>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4391 quality (0\-highest, 9\-lowest) (only for VBR)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4392 .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
4393 .B aq=<0\-9>
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4394 algorithmic quality (0\-best/\:slowest, 9\-worst/\:fastest)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4395 .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
4396 .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
4397 compression ratio
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4398 .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
4399 .B vol=<0\-10>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4400 set audio input gain
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4401 .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
4402 .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
4403 (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
4404 .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
4405 .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
4406 .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
4407 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
4408 .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
4409 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
4410 .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
4411 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
4412 .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
4413 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
4414 .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
4415 .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
4416 .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
4417 .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
4418 .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
4419 .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
4420 .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
4421 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
4422 .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
4423 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
4424 .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
4425 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
4426 .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
4427 .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
4428 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4429 .B fast\ \ \
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4430 switch on faster encoding on subsequent VBR presets modes, slightly lower
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4431 quality and higher bitrates.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4432 .TP
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4433 .B highpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4434 Set a highpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4435 Frequencies below the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
4436 A value of -1 will disable filtering, a value of 0
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4437 will let lame choose values automatically.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4438 .TP
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4439 .B lowpassfreq=<freq>
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4440 Set a lowpass filtering frequency in Hz.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4441 Frequencies above the specified one will be cut off.
11915
454a2eec34a9 lame accepts only integers, pointed out by iive.
diego
parents: 11911
diff changeset
4442 A value of -1 will disable filtering, a value of 0
11880
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4443 will let lame choose values automatically.
0e5317b4a41e Scale filter reworded, presize option documented, lowpassfreq and
diego
parents: 11873
diff changeset
4444 .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
4445 .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
4446 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
4447 .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
4448 .IPs medium
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4449 VBR encoding, good quality, 150\-180 kbps bitrate range.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4450 .IPs standard
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4451 VBR encoding, high quality, 170\-210 kbps bitrate range.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4452 .IPs extreme
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4453 VBR encoding, very high quality, 200\-240 kbps bitrate range.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4454 .IPs insane
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4455 CBR encoding, highest preset quality, 320 kbps bitrate.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4456 .IPs <8\-320>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4457 ABR encoding at average given kbps bitrate.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4458 .RE
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4459 .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
4460 .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
4461 .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
4462 .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
4463 .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
4464 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4465 .IPs fast:preset=standard
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4466 for most people on most music and already quite high in quality.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4467 .IPs cbr:preset=192
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4468 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
4469 .IPs preset=172
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4470 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
4471 .IPs preset=extreme
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4472 for people with extremely good hearing and similar equipment.
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4473 .IPs preset=help
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4474 print additional options and informations on presets settings.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4475 .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
4476 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4477 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4478 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4479 .SS lavc (\-lavcopts)
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4480 Many lavc options are very specialized and tersely documented.
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4481 Read the source for full details.
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4482 .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
4483 .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
4484 .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
4485 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4486 .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
4487 .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
4488 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4489 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4490 .TP
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4491 .B acodec=<value>
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4492 Audio codec (default: mp2):
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4493 .PD 0
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4494 .RSs
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4495 .IPs mp2
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4496 MPEG Layer 2
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4497 .IPs mp3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4498 MPEG Layer 3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4499 .IPs ac3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4500 AC3
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4501 .IPs adpcm_ima_wav
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4502 IMA Adaptive PCM (4bits per sample, 4:1 compression)
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4503 .RE
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4504 .PD 1
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4505 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4506 .B abitrate=<value>
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4507 Audio bitrate in kBit (default 224).
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4508 .TP
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4509 .B atag=<value>
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4510 Use the specified Windows audio format tag (e.g.\& atag=0x55).
11375
3544f1823f6b mencoder lavc audio encoding support
ranma
parents: 11366
diff changeset
4511 .TP
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
4512 .B bit_exact
11938
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4513 Use only bit exact algorithms (except (i)dct).
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4514 Additionally bit_exact disables several optimizations and thus
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4515 should only be used for regression tests, which need binary
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4516 identical files even if the encoder version changes.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4517 This also suppresses the user_data header in MPEG-4 streams.
803c7274ba55 better description bit_exact lavc option
diego
parents: 11931
diff changeset
4518 Do not use this option unless you know exactly what you are doing.
11931
d0b6a4de098c bit_exact lavc option, patch by "Steven M. Schultz" <sms@2BSD.COM>
diego
parents: 11927
diff changeset
4519 .TP
12778
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4520 .B threads=<1\-8>
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4521 Maximum number of threads to use (default: 1).
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4522 .RE
e8f118e80cde threads lavc option by Loren Merritt <lorenm@u.washington.edu>, typo
diego
parents: 12767
diff changeset
4523 .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
4524 .B vcodec=<value>
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4525 Use the specified codec (default: mpeg4):
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4526 .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
4527 .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
4528 .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
4529 Motion JPEG
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4530 .IPs ljpeg
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4531 Lossless JPEG
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4532 .IPs h263\
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4533 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
4534 .IPs h263p
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4535 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
4536 .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
4537 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
4538 .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
4539 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
4540 .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
4541 MS MPEG4v2
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4542 .IPs wmv1
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4543 Windows Media Video, version 1 (aka WMV7)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4544 .IPs wmv2
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4545 Windows Media Video, version 2 (aka WMV8)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4546 .IPs rv10
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4547 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
4548 .IPs mpeg1video
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4549 MPEG1 video
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4550 .IPs mpeg2video
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4551 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
4552 .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
4553 HuffYUV
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4554 .IPs asv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4555 ASUS Video v1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4556 .IPs asv2
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4557 ASUS Video v2
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4558 .IPs ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
4559 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
4560 .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
4561 .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
4562 .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
4563 .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
4564 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
4565 .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
4566 .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
4567 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
4568 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
4569 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
4570 .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
4571 Recommended for normal mpeg4/mpeg1video encoding (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
4572 .IPs 3
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4573 Recommended for h263(p)/msmpeg4.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4574 The reason for preferring 3 over 2 is that 2 could lead to overflows
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4575 (this will be fixed for h263(p) by changing the quantizer per MB in
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4576 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
4577 .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
4578 .TP
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4579 .B lmin=<0.01\-255.0>
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4580 Minimum lagrange multiplier for ratecontrol, you probably want it to be
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4581 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
4582 .RE
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4583 .TP
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4584 .B lmax=<0.01\-255.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4585 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
4586 .RE
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4587 .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
4588 .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
4589 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
4590 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
4591 1 is not recommended (see vqmin 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
4592 .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
4593 .B vqmax=<1\-31>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4594 maximum quantizer (pass\ 1/\:2) 10\-31 should be a sane range (default: 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
4595 .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
4596 .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
4597 minimum macroblock quantizer (pass\ 1/\:2) (default: 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
4598 .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
4599 .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
4600 maximum macroblock quantizer (pass\ 1/\:2) (default: 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
4601 .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
4602 .B vqdiff=<1\-31>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4603 maximum quantizer difference between I or P frames (pass\ 1/\:2) (default: 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
4604 .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
4605 .B vmax_b_frames=<0\-4>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4606 maximum number of B frames between non B frames:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4607 .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
4608 .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
4609 .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
4610 no B frames (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4611 .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
4612 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
4613 .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
4614 .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
4615 .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
4616 .B vme=<0\-5>
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4617 motion estimation method.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
4618 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4619 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4620 0\-3 currently ignores the amount of Bits spent,
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4621 so quality may be low.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4622 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
4623 .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
4624 .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
4625 .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
4626 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
4627 .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
4628 full (slow)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4629 .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
4630 log (low quality)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4631 .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
4632 phods (low quality)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4633 .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
4634 EPZS (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4635 .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
4636 X1 (experimental)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4637 .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
4638 .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
4639 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
4640 .B me_range=<0\-9999>
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
4641 motion estimation search range, 0 (default) means unlimited
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
4642 .TP
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4643 .B mbd=<0\-2>
10503
diego
parents: 10498
diff changeset
4644 Macroblock decision algorithm (high quality mode), encode each macro
diego
parents: 10498
diff changeset
4645 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
4646 This is slow but results in better quality and file size.
10498
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4647 .PD 0
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4648 .RSs
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4649 .IPs 0
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4650 use mbcmp (default)
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4651 .IPs 1
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4652 select the MB mode which needs the fewest bits (=vhq)
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4653 .IPs 2
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4654 select the MB mode which has the best rate distortion
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4655 .RE
17391ba6c53b mb decision stuff
michael
parents: 10393
diff changeset
4656 .PD 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
4657 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
4658 .B vhq\ \ \ \
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4659 Same as mbd=1, kept for compatibility reasons.
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4660 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4661 .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
4662 Allow 4 motion vectors per macroblock (slightly better 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
4663 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4664 .B obmc\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4665 overlapped block motion compensation (H.263+)
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4666 .TP
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4667 .B loop\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4668 loop filter (H.263+)
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4669 note, this is broken
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4670 .TP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
4671 .B inter_threshold <-1000\-1000>
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
4672 Does absolutely nothing at the moment.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
4673 .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
4674 .B keyint=<0\-300>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4675 maximum interval between keyframes in frames.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4676 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
4677 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
4678 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
4679 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
4680 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
4681 For a strict MPEG1/\:2/\:4 compliance this would have to be <=132.
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
4682 (default: 250 or one 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
4683 .TP
11699
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
4684 .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
4685 Threshold for scene change detection.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
4686 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
4687 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
4688 -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
4689 no scene changes are detected (default 0).
9165fbc7d89d scenechange_threshold command line option patch by (Balatoni Denes <pnis at coder dot hu>)
michael
parents: 11696
diff changeset
4690 .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
4691 .B vb_strategy=<0\-1>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4692 strategy to choose between I/\:P/\:B frames (pass\ 2):
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4693 .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
4694 .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
4695 always use the maximum number of B frames (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4696 .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
4697 avoid B frames in high motion scenes (will cause bitrate misprediction)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4698 .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
4699 .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
4700 .B vpass=<1\-2>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4701 Activates internal two pass mode, only specify if you wish to use two pass
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4702 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
4703 .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
4704 .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
4705 .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
4706 first pass
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4707 .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
4708 second pass
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4709 .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
4710 .PD 1
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
4711 .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
4712 .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
4713 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
4714 .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
4715 .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
4716 .RSs
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
4717 .IPs "pass 1"
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
4718 Saves statistics.
13037
f2358a08589b Missing quotes added.
diego
parents: 13036
diff changeset
4719 .IPs "pass 2"
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
4720 Encodes with an optimal Huffman table based upon statistics
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
4721 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
4722 .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
4723 .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
4724 .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
4725 .B aspect=<x/y>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4726 Store movie aspect internally, just like MPEG files.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4727 Much nicer solution than rescaling, because quality isn't decreased.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4728 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
4729 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
4730 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
4731 .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
4732 .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
4733 .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
4734 .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
4735 .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
4736 .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
4737 .IPs "aspect=16/9 or aspect=1.78"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4738 .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
4739 .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
4740 .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
4741 .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
4742 Same as the aspect option, but automatically computes aspect, taking
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4743 into account all the adjustments (crop/expand/scale/etc.) made in the
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4744 filter chain.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4745 .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
4746 .B vbitrate=<value>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4747 Specify bitrate (pass\ 1/\:2).
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4748 Warning: 1kBit = 1000 Bits.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4749 .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
4750 .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
4751 (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
4752 .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
4753 (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
4754 .IPs 800
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4755 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
4756 .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
4757 .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
4758 .B vratetol=<value>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4759 approximated filesize tolerance in kBit.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
4760 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
4761 (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
4762 (default: 8000)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
4763 .br
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4764 .I NOTE:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4765 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
4766 be problems if vrc_(min|max)rate is used.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4767 .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
4768 .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
4769 maximum bitrate in kbit/\:sec (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
4770 .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
4771 .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
4772 minimum bitrate in kbit/\:sec (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
4773 .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
4774 .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
4775 buffer size in kbit (pass\ 1/\:2).
11333
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4776 For MPEG1/2 this also sets the vbv buffer size, use 327 for VCD,
acb4c4a5ce8c Document lmin and lmax lavcopts; mpeg vrc_buf_size values
ranma
parents: 11313
diff changeset
4777 917 for SVCD and 1835 for DVD.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4778 .TP
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4779 .B vrc_buf_aggressivity
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4780 currently useless
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
4781 .TP
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4782 .B vrc_strategy
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4783 Dummy, reserved for future use.
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
4784 .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
4785 .B vb_qfactor=<-31.0\-31.0>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4786 quantizer factor between B and non B frames (pass\ 1/\:2) (default: 1.25)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4787 .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
4788 .B vi_qfactor=<-31.0\-31.0>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4789 (pass\ 1/\:2) (default: 0.8)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4790 .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
4791 .B vb_qoffset=<-31.0\-31.0>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4792 quantizer offset between B and non B frames (pass\ 1/\:2) (default: 1.25)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4793 .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
4794 .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
4795 (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
4796 .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
4797 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
4798 .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
4799 I/\:B-Frame quantizer = P-Frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4800 .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
4801 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
4802 .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
4803 do normal ratecontrol (dont lock to next P frame quantizer) and
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4804 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4805 .TP
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
4806 .B \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4807 Tip: To do constant quantizer encoding with different quantizers for
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4808 I/P and B frames you can use:
11696
85f1f61200ab lets see if lmin/lmax for constant IP quantizer and different constant quant for B works ...
michael
parents: 11694
diff changeset
4809 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/ip_quant>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4810 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4811 .B vqblur=<0.0\-1.0> (pass 1)
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4812 Quantizer blur, larger values will average the quantizer more over
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4813 time (slower change).
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4814 .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
4815 .IPs 0.0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4816 qblur disabled
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4817 .IPs 0.5
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4818 (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
4819 .IPs 1.0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4820 average the quantizer over all previous frames
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4821 .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
4822 .TP
11411
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4823 .B vqblur=<0.0\-99.0> (pass 2)
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4824 Quantizer gaussian blur, larger values will average the quantizer more
cb070e67a9c9 gammas --> gamma, vqblur clarified.
diego
parents: 11391
diff changeset
4825 over time (slower change) (default: 0.5).
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4826 .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
4827 .B vqcomp=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4828 quantizer compression, depends upon vrc_eq (pass\ 1/\:2) (default: 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
4829 .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
4830 .B vrc_eq=<equation>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4831 main ratecontrol equation (pass\ 1/\:2):
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4832 .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
4833 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4834 .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
4835 constant bitrate
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4836 .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
4837 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
4838 .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
4839 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
4840 .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
4841 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
4842 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4843 .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
4844 .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
4845 infix operators: +,-,*,/,^
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4846 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4847 .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
4848 .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
4849 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
4850 .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
4851 .RSs
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4852 .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
4853 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
4854 .IPs iTex,pTex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4855 intra, non intra texture complexity
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4856 .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
4857 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
4858 .IPs avgIITex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4859 average intra texture complexity in I frames
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4860 .IPs avgPITex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4861 average intra texture complexity in P frames
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4862 .IPs avgPPTex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4863 average non intra texture complexity in P frames
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4864 .IPs avgBPTex
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4865 average non intra texture complexity in B frames
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4866 .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
4867 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
4868 .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
4869 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
4870 .IPs iCount
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4871 number of intra macro blocks / number of macro blocks
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4872 .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
4873 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
4874 .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
4875 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
4876 .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
4877 qcomp from the command line
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4878 .IPs "isI, isP, isB"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4879 is 1 if picture type is I/\:P/\:B else 0
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4880 .IPs Pi,E\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4881 see your favorite math book
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4882 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
4883 .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
4884 .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
4885 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
4886 .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
4887 .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
4888 .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
4889 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
4890 .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
4891 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
4892 .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
4893 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
4894 .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
4895 is 1 if a==b, 0 otherwise
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4896 .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
4897 .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
4898 .
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4899 .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
4900 .B vrc_override=<options>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4901 User specified quality for specific parts (ending, credits, ..) (pass\ 1/\:2).
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4902 The options are <start-frame>, <end-frame>, <quality>[/\:<start-frame>,
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4903 <end-frame>, <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
4904 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
4905 .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
4906 quantizer
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
4907 .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
4908 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
4909 .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
4910 .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
4911 .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
4912 initial complexity (pass\ 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
4913 .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
4914 .B vqsquish=<0,1>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4915 specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2):
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4916 .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
4917 .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
4918 .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
4919 use clipping
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4920 .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
4921 use a nice differentiable function (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4922 .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
4923 .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
4924 .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
4925 .B vlelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4926 Sets single coefficient elimination threshold for luminance.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4927 Negative values will also consider the dc coefficient (should be at least -4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4928 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
4929 .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
4930 .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
4931 .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
4932 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
4933 .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
4934 (JVT recommendation)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4935 .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
4936 .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
4937 .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
4938 .B vcelim=<-1000\-1000>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
4939 Sets single coefficient elimination threshold for chrominance.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4940 Negative values will also consider the dc coefficient (should be at least -4
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4941 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
4942 .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
4943 .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
4944 .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
4945 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
4946 .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
4947 (JVT recommendation)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4948 .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
4949 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4950 .B 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
4951 strict standard compliance
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4952 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4953 .IPs 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
4954 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
4955 .IPs 1
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4956 only recommended if you want to feed the output into the MPEG4 reference
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4957 decoder
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4958 .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
4959 allows non-standard YV12 huffyuv encoding (20% smaller files, but cannot be
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4960 played by the official huffyuv codec)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4961 .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
4962 .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
4963 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
4964 .B vdpart\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4965 data partitioning.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4966 Adds 2 Bytes per video packet, improves error-resistance when transferring over
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4967 unreliable channels (eg.\& streaming over the internet)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4968 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
4969 .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
4970 .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
4971 .IPs "1. MVs"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4972 (movement)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4973 .IPs "2. DC coefficients"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4974 (low res picture)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4975 .IPs "3. AC coefficients"
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4976 (details)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4977 .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
4978 .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
4979 .TP
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
4980 .B \
10382
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4981 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
4982 the AC and the 1. & 2. partition.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4983 (MV&DC) are far smaller than the 3. partition (AC) meaning that errors
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4984 will hit the AC partition much more often than the MV&DC partitions.
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4985 Thus, the picture will look better with partitioning than without,
9b0c08383461 Sentences should start on a new line.
diego
parents: 10380
diff changeset
4986 as without partitioning an error will trash AC/DC/MV equally.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4987 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4988 .B vpsize=<0\-10000>
8627ec205af8 moved -af options to the 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 video packet size, improves error-resistance (see \-vdpart option too):
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
4990 .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
4991 .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
4992 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
4993 .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
4994 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
4995 .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
4996 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4997 .B ss\ \ \ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
4998 slice structured mode for H.263+
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
4999 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5000 .B gray\ \ \
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5001 grayscale only encoding (faster)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5002 .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
5003 .B vfdct=<0\-10>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5004 dct algorithm:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5005 .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
5006 .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
5007 .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
5008 automatically select a good one (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5009 .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
5010 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
5011 .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
5012 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
5013 .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
5014 mmx
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5015 .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
5016 mlib
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5017 .IPs 5
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5018 altivec
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5019 .IPs 6
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5020 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
5021 .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
5022 .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
5023 .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
5024 .B idct=<0\-99>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5025 idct algorithm.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5026 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5027 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5028 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
5029 .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
5030 .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
5031 .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
5032 automatically select a good one (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5033 .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
5034 jpeg reference integer
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5035 .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
5036 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
5037 .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
5038 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
5039 .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
5040 libmpeg2mmx (inaccurate, DON'T USE for encoding with keyint >100)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5041 .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
5042 ps2
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5043 .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
5044 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
5045 .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
5046 arm
11237
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5047 .IPs 8
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5048 altivec
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5049 .IPs 9
1c8ba87ddb03 (i)dct algos
michael
parents: 11228
diff changeset
5050 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
5051 .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
5052 .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
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 lumi_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5055 luminance masking
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5056 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5057 .I WARNING:
13052
27c1f3ae682e spelling/wording consistency as suggested by the Wanderer
diego
parents: 13049
diff changeset
5058 Be careful, overly large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5059 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5060 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5061 Large values might look good on some monitors but may look horrible
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5062 on other monitors:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5063 .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
5064 .IPs 0.0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5065 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
5066 .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
5067 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
5068 .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
5069 .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
5070 .B dark_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5071 darkness masking
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5072 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5073 .I WARNING:
13046
ae4c33cf4bd2 minor fixes
diego
parents: 13042
diff changeset
5074 Be careful, too large values can cause disastrous things.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5075 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5076 .I WARNING:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5077 Large values might look good on some monitors but may look horrible
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5078 on other monitors / TV / TFT:
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5079 .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
5080 .IPs 0.0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5081 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
5082 .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
5083 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
5084 .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
5085 .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
5086 .B tcplx_mask=<0.0\-1.0>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5087 temporal complexity masking (default: 0.0 (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
5088 .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
5089 .B scplx_mask=<0.0\-1.0>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5090 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
5091 Larger values help against blockiness, if no deblocking filter is used for
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5092 decoding.
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5093 .br
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5094 .I HINT:
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5095 Crop any black borders completely as they will reduce the quality
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5096 of the macro blocks (also applies without scplx_mask).
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5097 .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
5098 .IPs 0.0
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5099 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
5100 .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
5101 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
5102 .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
5103 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5104 .B p_mask=<0.0\-1.0>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5105 inter MB masking (default: 0.0 (disabled))
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5106 .TP
11430
nicolas
parents: 11424
diff changeset
5107 .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
5108 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
5109 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
5110 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
5111 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
5112 average.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5113 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5114 .B ildct\ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5115 use interlaced dct
8627ec205af8 moved -af options to the 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 .TP
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5117 .B ilme\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
5118 Use interlaced motion estimation (mutually exclusive with qpel).
11702
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5119 .TP
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5120 .B alt\ \ \ \
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5121 use alternative scantable
e4c043ebf3a6 vismv, alt, ilme options
michael
parents: 11700
diff changeset
5122 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5123 .B top=<-1\-1>\ \ \
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5124 .RSs
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5125 .IPs -1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5126 automatic
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5127 .IPs 0
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5128 bottom field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5129 .IPs 1
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5130 top field first
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5131 .RE
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5132 .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
5133 .B format=<value>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5134 .RSs
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5135 .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
5136 default
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5137 .IPs 444P
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5138 for ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5139 .IPs 422P
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5140 for huffyuv, lossless jpeg and ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5141 .IPs 411P,YVU9
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5142 for lossless jpeg and ffv1
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5143 .IPs BGR32
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5144 for lossless jpeg and ffv1
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5145 .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
5146 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5147 .B pred\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5148 (for huffyuv)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5149 .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
5150 .RSs
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5151 .IPs 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
5152 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
5153 .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
5154 plane/gradient 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
5155 .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
5156 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
5157 .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
5158 .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
5159 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5160 .B pred\ \ \
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5161 (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
5162 .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
5163 .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
5164 .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
5165 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
5166 .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
5167 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
5168 .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
5169 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
5170 .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
5171 plane/gradient 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
5172 .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
5173 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
5174 .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
5175 .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
5176 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5177 .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
5178 (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
5179 .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
5180 .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
5181 .IPs 0
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
5182 vlc coding (golomb rice)
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
5183 .IPs 1
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
5184 arithmetic coding (cabac)
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
5185 .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
5186 .PD 1
e007ae3e06cf document -lavcopts coder for ffv1 (-lavcopts docs needs a big reviewing, imho half of the features aren't documented)
alex
parents: 10991
diff changeset
5187 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5188 .B context
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5189 (for ffv1)
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5190 .PD 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5191 .RSs
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5192 .IPs 0
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5193 small context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5194 .IPs 1
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5195 large context model
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5196 .RE
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5197 .PD 1
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5198 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5199 .B qpel\ \ \
12970
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
5200 Use quarter pel motion compensation (mutually exclusive with ilme).
2b57ae8d21dd qpel and ilme lavc options are mutually exclusive.
diego
parents: 12948
diff changeset
5201 Hint: This seems only useful for high bitrate encodings.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5202 .TP
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5203 .B ildctcmp=<0\-2000>
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5204 comparison function for interlaced dct decision
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5205 .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
5206 .B precmp=<0\-2000>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5207 comparison function for 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
5208 .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
5209 .B cmp=<0\-2000>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5210 comparison function for full pel motion estimation
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5211 .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
5212 .B subcmp=<0\-2000>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5213 comparison function for sub pel motion estimation
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5214 .TP
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5215 .B mbcmp=<0\-2000>
11382
f11f62f1242a vhq and vrc_strategy lavc options documented, spelling.
diego
parents: 11380
diff changeset
5216 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
5217 .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
5218 .RSs
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5219 .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
5220 sum of absolute differences, fast (default)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5221 .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
5222 sum of squared errors
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5223 .IPs "2 (SATD)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5224 sum of absolute hadamard transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5225 .IPs "3 (DCT)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5226 sum of absolute dct transformed differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5227 .IPs "4 (PSNR)"
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5228 sum of the squared quantization errors (don't use, low quality)
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5229 .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
5230 number of bits needed for the block
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5231 .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
5232 rate distortion optimal, slow
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5233 .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
5234 0
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5235 .IPs "8 (VSAD)"
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5236 sum of absolute vertical differences
11753
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5237 .IPs "9 (VSSE)"
ce75cb364b19 ildctcmp, VSAD, VSSE
michael
parents: 11749
diff changeset
5238 sum of squared vertical differences
12593
michael
parents: 12581
diff changeset
5239 .IPs "10 (NSSE)"
michael
parents: 12581
diff changeset
5240 noise preserving sum of squared differences
10386
f726201d9c5b Quote all .IPs with more than one argument (necessary!).
diego
parents: 10385
diff changeset
5241 .IPs +256\
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5242 use chroma too, doesn't work (correctly) with B frames currently
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5243 .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
5244 .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
5245 .TP
12607
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
5246 .B nssew=<0\-100>
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
5247 NSSE weight, larger weights will result in more noise,
5d4f5965d05f 10l for Michael, nsse_weight should be nssew, spelling.
diego
parents: 12598
diff changeset
5248 with 0 NSSE is identical to SSE.
12593
michael
parents: 12581
diff changeset
5249 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5250 .B predia=<-99\-6>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5251 Diamond type and size for 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
5252 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5253 .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
5254 Diamond type & size for motion estimation.
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5255 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5256 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5257 The sizes of the normal diamonds and shape adaptive ones don't have
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5258 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
5259 .RSs
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5260 .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
5261 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
5262 .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
5263 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
5264 .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
5265 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
5266 .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
5267 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
5268 .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
5269 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5270 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
5271 000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5272 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
5273 .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
5274 .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
5275 .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
5276 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
5277 .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
5278 .ne
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5279 0
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5280 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
5281 00000
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5282 000
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5283 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
5284 .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
5285 .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
5286 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5287 .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
5288 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
5289 This will find the optimal encoding for each 8x8 block.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5290 Trellis searched quantization is quite simple a optimal quantization in the PSNR
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5291 vs bitrate sense (assuming that there would be no rounding errors introduced
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5292 by the IDCT, which is obviously not the case) it simply finds a block for
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5293 the minimum of error and lambda*bits.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5294 .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
5295 .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
5296 .IPs lambda
8627ec205af8 moved -af options to the 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 qp dependant constant
10387
274c724a08ec Added trailing spaces to fix broken indentation.
diego
parents: 10386
diff changeset
5298 .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
5299 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
5300 .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
5301 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
5302 .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
5303 .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
5304 .TP
10963
michael
parents: 10917
diff changeset
5305 .B cbp\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5306 Rate distorted optimal coded block pattern.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5307 Will select the coded block pattern which minimizes distortion + lambda*rate.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5308 This can only be used together with trellis quantization.
10963
michael
parents: 10917
diff changeset
5309 .TP
10974
michael
parents: 10969
diff changeset
5310 .B mv0\ \ \ \
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5311 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
5312 This has no effect if mbd=0.
10974
michael
parents: 10969
diff changeset
5313 .TP
11446
michael
parents: 11443
diff changeset
5314 .B qprd\ \ \
12581
602a2796e353 qprd needs mbd=2
michael
parents: 12559
diff changeset
5315 rate distorted optimal QP for the given lambda of each macroblock, note this
602a2796e353 qprd needs mbd=2
michael
parents: 12559
diff changeset
5316 needs mbd=2
11446
michael
parents: 11443
diff changeset
5317 .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
5318 .B last_pred=<0\-99>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5319 Amount of motion predictors from the previous frame
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5320 .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
5321 .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
5322 .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
5323 (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
5324 .IPs a
8627ec205af8 moved -af options to the 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 will use 2a+1 x 2a+1 macro block square of motion vector predictors from the
8627ec205af8 moved -af options to the 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 previous frame
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5327 .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
5328 .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
5329 .TP
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5330 .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
5331 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
5332 .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
5333 .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
5334 .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
5335 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
5336 .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
5337 only after I frames (default)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5338 .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
5339 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
5340 .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
5341 .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
5342 .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
5343 .B subq=<1\-8>
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5344 subpel refinement quality (for qpel) (default: 8).
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5345 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5346 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5347 This has a significant effect on speed.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5348 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5349 .B psnr\ \ \
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5350 print the psnr (peak signal to noise ratio) for the whole video after 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
5351 and store the per frame psnr in a file with a name like 'psnr_hhmmss.log'.
8627ec205af8 moved -af options to the 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 Returned values are in dB (decibel), the higher the better.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5353 .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
5354 .B mpeg_quant
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5355 Use MPEG quantizers instead of 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
5356 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5357 .B aic\ \ \ \
10966
a7c027115939 latest lavc uses the AIC flag also to turn mpeg4 ac prediction on/off
michael
parents: 10963
diff changeset
5358 ac prediction (=advanced intra prediction for H.263+)
13042
f7eabbad1861 missing .br's added
wight
parents: 13040
diff changeset
5359 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5360 .I NOTE:
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5361 vqmin should be 8 or larger for AIC 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
5362 .TP
11671
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5363 .B aiv\ \ \ \
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5364 alternatice inter vlc for H.263+
f7e10875d102 lavc options: obmc,top,loop.aiv,ss
michael
parents: 11667
diff changeset
5365 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5366 .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
5367 unlimited MVs (H.263+ only)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5368 Allow encoding of abritarily long MVs.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5369 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5370 .B ibias=<-256\-256>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5371 intra quantizer bias (256 == 1.0)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5372 .br
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5373 MPEG style quantizer default: 96
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5374 .br
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5375 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
5376 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5377 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5378 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
5379 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
5380 .TP
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5381 .B pbias=<-256\-256>
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5382 inter quantizer bias (256 == 1.0)
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5383 .br
13031
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5384 MPEG style quantizer default: 0
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5385 .br
37d93e894709 Clarify a few things, spelling and wording fixes, some of this belongs to
diego
parents: 13029
diff changeset
5386 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
5387 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5388 .I NOTE:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5389 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
5390 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
5391 .br
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5392 Tip: a more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5393 .TP
11380
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5394 .B nr=<0\-100000>
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5395 noise reduction, 0 is disabled
45196162f12d forgotten lavc options ...
michael
parents: 11375
diff changeset
5396 .TP
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5397 .B qns=<0\-3>
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5398 Quantizer noise shaping, reduces ringing artefacts, larger values are slower
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5399 but may not result in better quality.
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5400 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
5401 the trellis quantization (optimal for constant weight) will be used as
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5402 startpoint for the iterative search.
11910
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5403 .PD 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5404 .RSs
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5405 .IPs 0
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5406 disabled (default)
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5407 .IPs 1
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5408 only lower the absolute value of coefficients
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5409 .IPs 2
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5410 only change coefficients before the last non zero coefficient + 1
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5411 .IPs 3
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5412 try all
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5413 .RE
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5414 .PD 1
2f54892f0598 quantizer noise shaping
michael
parents: 11906
diff changeset
5415 .TP
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5416 .B inter_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5417 Use custom inter matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5418 It needs a comma separated string of 64 integers.
10781
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5419 .TP
c35abe9c3ec8 overall fixes and documented inter/intra_matrix option in manpage
alex
parents: 10770
diff changeset
5420 .B intra_matrix=<comma separated matrix>
12991
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5421 Use custom intra matrix.
2d678d3c00fa typo and consistency fixes
diego
parents: 12990
diff changeset
5422 It needs a comma separated string of 64 integers.
11551
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5423 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5424 .B vqmod_amp
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5425 experimental quantizer modulation
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5426 .TP
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5427 .B vqmod_freq
24697d0d96a2 last missing lavc options
diego
parents: 11542
diff changeset
5428 experimental quantizer modulation
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5429 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5430 .B dc\ \ \ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5431 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
5432 If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5433 .TP
13001
51f4691ddc02 Break some lines, stray .RE removed.
diego
parents: 12995
diff changeset
5434 .B cgop\ \ \
12813
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5435 Close all GOPs.
62e778e80b41 cd and cgop lavc options documented, based on a patch by Nico Sabbi.
diego
parents: 12808
diff changeset
5436 Currently it doesn't work (yet).
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5437 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5438 .SS nuv (\-nuvopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5439 .
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5440 Nuppel video is based on rtjpeg and lzo.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5441 By default frames are first encoded with rtjpeg and then compressed with lzo.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5442 But both passes can be enabled or not.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5443 So you can in fact output raw i420, lzo compressed i420, rtjpeg, or the
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5444 default lzo compressed rtjpeg.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5445 .br
11552
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5446 .I NOTE:
db26f9ae122a NOTE: now uniformly handled.
diego
parents: 11551
diff changeset
5447 The nuvrec documentation contains some advice and examples about the
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5448 settings to use for the most common TV encodings.
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5449 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5450 .B c=<0\-20>
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5451 chrominance threshold
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5452 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5453 .B l=<0\-20>
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5454 luminance threshold
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5455 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
5456 .B nolzo \
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5457 Disable the lzo compression.
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5458 .TP
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5459 .B q=<3\-255>
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5460 Set the quality level.
10700
517dd95f5fb2 -nuvopts documentation by Albeu
diego
parents: 10695
diff changeset
5461 .TP
11144
280e463ab855 wording, cosmetics, updates
diego
parents: 11137
diff changeset
5462 .B raw \ \ \
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5463 Disable rtjpeg encoding.
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5464 .TP
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5465 .B rtjpeg\
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5466 Enable rtjpeg encoding.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5467 .
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5468 .SS xvidenc (\-xvidencopts)
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5469 .
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5470 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
5471 2pass.
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5472 .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
5473 .B pass=<1|2>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5474 Specify the pass in 2pass mode.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5475 .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
5476 .B bitrate=<value>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5477 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
5478 if >16000.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5479 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5480 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
5481 (in kbytes) of the video and compute the associated bitrate automagically.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5482 (CBR or 2pass mode, default: 687 kbits/s)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5483 .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
5484 .B fixed_quant=<1\-31>
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5485 Switch to fixed quantizer mode and specify the quantizer to be used.
10380
8627ec205af8 moved -af options to the 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
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5487 .B me_quality=<0\-6>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5488 This option controls the motion estimation subsystem.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5489 The higher the value, the more precise the estimation should be.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5490 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
5491 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
5492 you need realtime encoding.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5493 (default: 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
5494 .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
5495 .B interlacing
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5496 Encode the fields of interlaced video material.
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5497 Turn this option on for interlaced content.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5498 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5499 .B 4mv\ \ \ \
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5500 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
5501 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
5502 .br
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5503 .I WARNING:
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5504 This option doesn't exist in XviD-1.0.x.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5505 .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
5506 .B rc_reaction_delay_factor=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5507 This parameter controls the delay in frames before the CBR rate controller
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5508 will react to bitrate changes and will try to compensate the change to obtain
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5509 a constant bitrate over an averaging range of 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
5510 .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
5511 .B rc_averaging_period=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5512 Real CBR is hard to achieve.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5513 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
5514 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
5515 amount of bits (minus a small variation).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5516 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
5517 bitrate and tries to achieve CBR.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5518 .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
5519 .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
5520 size of the rate control buffer
10380
8627ec205af8 moved -af options to the 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 .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
5522 .B quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>]
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5523 min & max quantizer for all frames (default: 2\-31, CBR mode)
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5524 .br
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5525 min & max quantizer for I/P frames (default: 2\-31/2\-31, 2pass mode)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5526 .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
5527 .B min_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5528 minimum interval between keyframes (default: 0, 2pass only)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5529 .TP
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5530 .B max_key_interval=<value>
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5531 maximum interval between keyframes (default: 10*fps)
10380
8627ec205af8 moved -af options to the 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 .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
5533 .B mpeg_quant
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5534 Use MPEG quantizers instead of H.263.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5535 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
5536 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
5537 When using custom matrices, MPEG must be used.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5538 .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
5539 .B mod_quant
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5540 Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5541 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5542 .I WARNING:
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5543 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
5544 by any MPEG4 decoder besides libavcodec or XviD.
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5545 (2pass mode only)
10380
8627ec205af8 moved -af options to the 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 .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
5547 .B greyscale
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5548 Make XviD discard chroma planes so the encoded video is greyscale only.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5549 Note that this does not speed up encoding, it just prevents chroma data
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5550 from being written in the last stage of 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
5551 .TP
11186
25ea0b19c07c -nuvopts rtjpeg + small fixes
diego
parents: 11185
diff changeset
5552 .B debug\ \
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5553 Save per-frame statistics in ./xvid.dbg.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5554 This is NOT the 2pass control file.
10380
8627ec205af8 moved -af options to the 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 .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
5556 .B keyframe_boost=<0\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5557 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
5558 thus improving keyframe quality.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5559 (default: 0, 2pass mode only)
10380
8627ec205af8 moved -af options to the 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 .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
5561 .B kfthreshold=<value>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5562 (default: 10, 2pass mode only)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5563 .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
5564 .B kfreduction=<0\-100>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5565 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
5566 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
5567 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
5568 kfreduction determines the bitrate reduction they get.
12987
98233a9ab00b trailing whitespace cosmetics
diego
parents: 12986
diff changeset
5569 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
5570 (default: 30, 2pass mode only)
7733
f81d2bd595a2 changed/added speed, channels, dumpsub, info, xvidencopts, lav[dc]opts options, restructured lavcopts, fixed some syntax errors
jonas
parents: 7701
diff changeset
5571 .RE
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5572 .PP
12988
a0512367674a Empty lines are not good troff markup, use .sp 1 instead.
diego
parents: 12987
diff changeset
5573 .sp 1
11941
36e2b0b40a87 filmdint=fast description corrected, xvidencopts clarified.
diego
parents: 11938
diff changeset
5574 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
5575 releases of XviD 1.0.x (api4).
10380
8627ec205af8 moved -af options to the 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 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5577 .B packed\
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5578 Create a bitstream which can be decoded delay-free.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
5579 .br
9818
rguyom
parents: 9809
diff changeset
5580 .I WARNING:
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5581 This will generate an illegal bitstream, and WILL NOT be
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5582 decodable by ISO-MPEG4 decoders except DivX/libavcodec/XviD.
9807
b8c22f746218 packed warning
michael
parents: 9806
diff changeset
5583 .br
9818
rguyom
parents: 9809
diff changeset
5584 .I WARNING:
13039
2db75904034b Consistency, punctuation, some minor fixes/clarifications.
wight
parents: 13037
diff changeset
5585 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
5586 autodetection of some decoders might be confused.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5587 .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
5588 .B divx5bvop
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5589 generate DivX5 compatible B-frames (default: on)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5590 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5591 .B qpel\ \ \
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5592 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
5593 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
5594 pixel precision.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5595 This option usually results in a sharper image.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5596 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
5597 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
5598 quality at a fixed bitrate.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5599 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
5600 is worth activating.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5601 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5602 .B gmc\ \ \ \
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5603 Enable Global Motion Compensation, which makes XviD generate special
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5604 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
5605 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
5606 dependent on the source material.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5607 .TP
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5608 .B trellis
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5609 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
5610 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
5611 compressible by the entropy encoder.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5612 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
5613 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
5614 quality at fixed bitrate) at a lesser cost than with VHQ.
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5615 .TP
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5616 .B cartoon
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5617 Activate this if your encoded sequence is an anime/cartoon.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5618 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
5619 frame types and motion vectors for flat looking cartoons.
10380
8627ec205af8 moved -af options to the 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 chroma_me
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5622 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
5623 find the best motion vector.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5624 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
5625 better vectors.
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5626 This setting toggles the use of chroma planes for motion estimation.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5627 .TP
8627ec205af8 moved -af options to the 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 .B chroma_opt
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5629 Enable a chroma optimizer prefilter.
13053
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
5630 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
5631 stepped-stairs effect on edges.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
5632 It will improve quality at the cost of encoding speed.
d59a2274442c better description of the chroma_opt XviD option
diego
parents: 13052
diff changeset
5633 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
5634 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
5635 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
5636 encoding in greyscale.
10380
8627ec205af8 moved -af options to the 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 .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
5638 .B reduced
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5639 Enable encoding reduced-resolution frames.
13014
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5640 .br
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5641 .I WARNING:
2f45d852b7c1 better XviD option descriptions by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 13005
diff changeset
5642 The bitstream created is outside any MPEG-4 profile!
13021
d870a59cde76 Wording and spelling improvements, mostly suggested by the Wanderer.
diego
parents: 13016
diff changeset
5643 This means it most likely won't be decodable by anything except XviD.
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5644 .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
5645 .B max_bframes=<0\-4>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5646 maximum number of B frames to put between I/P frames (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
5647 .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
5648 .B bquant_ratio=<0\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5649 quantizer ratio between B and non B frames, 150=1.50 (default: 150)
10380
8627ec205af8 moved -af options to the filter section (should work with mencoder), split encoding options in general and codec specific part, some small (cosmetic) changes
jonas
parents: 10375
diff changeset
5650 .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
5651 .B bquant_offset=<-1000\-1000>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5652 quantizer offset between B and non B frames, 100=1.00 (default: 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
5653 .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
5654 .B bf_threshold=<-255\-255>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5655 Sometimes B frames do not look good, and introduce artifacts when most of
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5656 the frame is static and some small zones have high motion (in a static
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5657 scene with a man talking, his mouth will probably look bad if what is
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5658 surrounding the man and his mouth is completly static).
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5659 This setting allows you to favorize or not, the use of B frames.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5660 The higher the value, the higher the probability of B frames being used.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5661 (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
5662 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5663 .B hq_ac\ \
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5664 Activates High Quality AC coefficient prediction from neighbor blocks.
10380
8627ec205af8 moved -af options to the 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 .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
5666 .B vhq=<0\-4>
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5667 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
5668 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
5669 reference frame and the encoded frame.
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5670 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
5671 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
5672 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
5673 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
5674 .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
5675 .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
5676 .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
5677 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
5678 .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
5679 mode decision (inter/intra MB)
8627ec205af8 moved -af options to the 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 .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
5681 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
5682 .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
5683 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
5684 .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
5685 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
5686 .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
5687 .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
5688 .TP
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5689 .B aspect=<x/y | f (float value)>
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5690 Store movie aspect internally, just like MPEG files.
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5691 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
5692 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
5693 will display them with the wrong aspect.
11916
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5694 The aspect parameter can be given as a ratio or a floating point number.
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5695 .TP
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5696 .B autoaspect
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5697 Same as the aspect option, but automatically computes aspect, taking
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5698 into account all the adjustments (crop/expand/scale/etc.) made in the
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5699 filter chain.
c5d09d43133f xvid4 new aspect options - patch by Nico <nsabbi@tiscali.it>
iive
parents: 11915
diff changeset
5700 .TP
10385
efa8e2fb2262 Set default indentation depth to 5.
diego
parents: 10384
diff changeset
5701 .B psnr\ \ \
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5702 Print the psnr (peak signal to noise ratio) for the whole video after encoding
12978
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5703 and store the per frame psnr in a file with a name like 'psnr_hhmmss.log' in
fd3f2cacd434 XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
diego
parents: 12970
diff changeset
5704 the current directory.
9809
508dc4231269 Actually do something useful with XVID_GLOBAL_EXTRASTATS / XVID_EXTRASTATS.
rguyom
parents: 9808
diff changeset
5705 Returned values are in dB (decibel), the higher the better.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5706 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5707 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5708 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5709 .\" Files
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5710 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5711 .
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5712 .SH FILES
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5713 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5714 /etc/\:mplayer/\:mplayer.conf
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5715 system-wide settings
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5716 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5717 ~/.mplayer/\:config
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5718 user settings
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5719 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5720 ~/.mplayer/\:input.conf
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5721 input bindings (see '\-input keylist' for full keylist)
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5722 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5723 ~/.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
5724 GUI configuration file
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
5725 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5726 ~/.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
5727 GUI playlist
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
5728 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5729 ~/.mplayer/\:font/
6752
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5730 font directory (There must be a font.desc file and files with .RAW extension.)
224fe311f5f6 Huge patch by Jonas Jermann <jjermann@gmx.net> (1/2).
diego
parents: 6747
diff changeset
5731 .TP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5732 ~/.mplayer/\:DVDkeys/
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
5733 cached CSS keys
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
5734 .TP
10870
88e23562bfba minor updates
diego
parents: 10865
diff changeset
5735 Sub files are searched for in this order (for example /mnt/\:cdrom/\:movie.avi):
10782
0fbcb4c16bfc some more fixes
alex
parents: 10781
diff changeset
5736 .RS
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5737 /mnt/\:cdrom/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
5738 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5739 ~/.mplayer/\:sub/\:movie.sub
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
5740 .br
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5741 ~/.mplayer/\:default.sub
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5742 .RE
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5743 .PD 1
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5744 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5745 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5746 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5747 .\" Examples
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5748 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5749 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5750 .SH EXAMPLES
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5751 .TP
1714
b42b78566029 *** empty log message ***
gabucino
parents: 1702
diff changeset
5752 .B Quickstart DVD playing
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5753 mplayer dvd://1
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5754 .TP
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
5755 .B Play in japanese with english subtitles
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5756 mplayer dvd://1 \-alang ja \-slang en
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
5757 .TP
4398
4039f5580f76 -chapter option updates (and some else?)
gabucino
parents: 4389
diff changeset
5758 .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
5759 mplayer dvd://1 \-chapter 5-7
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5760 .TP
12544
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
5761 .B Play only titles 5, 6, 7
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
5762 mplayer dvd://5-7
b81c451139a3 dvd:// now supports title ranges, patch by Roberto Togni.
diego
parents: 12505
diff changeset
5763 .TP
1714
b42b78566029 *** empty log message ***
gabucino
parents: 1702
diff changeset
5764 .B Multiangle DVD playing
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5765 mplayer dvd://1 \-dvdangle 2
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5766 .TP
1714
b42b78566029 *** empty log message ***
gabucino
parents: 1702
diff changeset
5767 .B Playing from a different DVD device
11094
01c2a08cdaeb Consistency in the use of \- vs - plus a typo or two.
diego
parents: 11059
diff changeset
5768 mplayer dvd://1 \-dvd-device /dev/\:dvd2
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5769 .TP
1714
b42b78566029 *** empty log message ***
gabucino
parents: 1702
diff changeset
5770 .B Stream from HTTP
7740
99aba45167f5 rewrite (again ;), cosmetics, no real changes
jonas
parents: 7737
diff changeset
5771 mplayer http://mplayer.hq/\:example.avi
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5772 .TP
7813
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
5773 .B Stream using RTSP
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
5774 mplayer rtsp://server.example.com/\:streamName
76940a39405a RTSP/RTP documentation, patch by Ross Finlayson <finlayson@live.com>.
diego
parents: 7794
diff changeset
5775 .TP
12467
5b1458ea64c9 AUDIO OUTPUT DRIVER section added, VO section extended, small fixes.
diego
parents: 12461
diff changeset
5776 .B Convert subtitle to MPsub (to ./dump.mpsub)
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
5777 mplayer dummy.avi \-sub source.sub \-dumpmpsub
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
5778 .TP
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5779 .B Convert subtitle to MPsub without watching the movie
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5780 mplayer /dev/zero \-rawvideo on:pal:fps=xx \-vc null \-vo null \-noframedrop
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5781 \-benchmark \-sub source.sub \-dumpmpsub
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5782 .TP
5683
588237bcd14c applied goth (Jonas Jermann)'s patch
gabucino
parents: 5619
diff changeset
5783 .B Input from standard V4L
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5784 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
5785 \-vo xv
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5786 .TP
12028
91eb4f10a9ad spelling fixes
diego
parents: 12016
diff changeset
5787 .B Playback on Zoran card (old style, deprecated)
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
5788 mplayer -vo zr -vf scale=352:288 file.avi
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
5789 .TP
12028
91eb4f10a9ad spelling fixes
diego
parents: 12016
diff changeset
5790 .B Playback on Zoran card (new style)
11667
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
5791 mplayer -vo zr2 -vf scale=352:288,zrmjpeg file.avi
7606ed34d2ad zrmjpeg options and two examples, per Diego's request
rik
parents: 11644
diff changeset
5792 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5793 .B Encoding DVD title #2, only selected chapters
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
5794 mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5795 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5796 .B Encoding DVD title #2, resizing to 640x480
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
5797 mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5798 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5799 .B Encoding 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
5800 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
5801 \-ovc lavc \-lavcopts vcodec=mpeg4
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5802 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5803 .B The same, but with libavcodec family, MPEG4 (Divx5) compression
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5804 mencoder dvd://2 \-o title2.avi \-ovc lavc
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5805 \-lavcopts vcodec=mpeg4:vhq:vbitrate=1800 \-oac copy
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5806 .TP
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
5807 .B The same, but with libavcodec family, MJPEG compression
9971
0ed75f50f2df Updates for the new xxx:// syntax and numerous clarifications.
diego
parents: 9954
diff changeset
5808 mencoder dvd://2 \-o titel2.avi \-ovc lavc
7288
159a5be61015 rewrite (much ;), no content change
jonas
parents: 7284
diff changeset
5809 \-lavcopts vcodec=mjpeg:vhq:vbitrate=1800 \-oac copy
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
5810 .TP
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5811 .B Encoding 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
5812 mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5813 .TP
12808
6d30eb7e08c6 clarification
diego
parents: 12807
diff changeset
5814 .B Encoding from tuner (specify a format with \-vf format)
11966
b58fdd5d8e8d remove raw nonsense and replace it by one ovc
attila
parents: 11954
diff changeset
5815 mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
5988
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5816 .TP
de86623c35ef merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
arpi
parents: 5965
diff changeset
5817 .B Encoding from a pipe
12479
7130dfe37fe5 Change divx4 examples to lavc, based on a patch by Compn.
diego
parents: 12472
diff changeset
5818 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
5819 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5820 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5821 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5822 .\" Bugs, authors, standard disclaimer
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5823 .\" --------------------------------------------------------------------------
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5824 .
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5825 .SH BUGS
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5826 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
5827 of the documentation first.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5828 Many bugs are the result of incorrect setup or parameter usage.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5829 The bug reporting section of the documentation (DOCS/HTML/en/bugreports.html)
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5830 explains how to create useful bug reports.
11539
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5831 .
2364dda5fe7e bug fixes, cleanup, consistency, uniformity
diego
parents: 11465
diff changeset
5832 .
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5833 .SH AUTHORS
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5834 MPlayer was initially written by Arpad Gereoffy.
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5835 See the AUTHORS file for a list of some of the many other contributors.
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
5836 .TP
11796
f4305ab15f4f Time to bump the dates, filter configuration file example, .TH expanded.
diego
parents: 11782
diff changeset
5837 MPlayer is (C) 2000\-2004
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5838 .B The MPlayer Team
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
5839 .TP
6469
caac66533fa0 Tons of typos plus wording updated here and there.
diego
parents: 6397
diff changeset
5840 This man page is written and maintained by
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5841 .B Gabucino
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
5842 .br
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5843 .B Diego Biurrun
7744
6d41f5e905e2 reversed some changes as they produced ugly html output
jonas
parents: 7740
diff changeset
5844 .br
7235
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5845 .B Jonas Jermann
81eb93508042 preparation for future format, cosmetic changes (subfont, comments, etc), no real changes
jonas
parents: 7219
diff changeset
5846 .PP
11694
3e4a090f3a39 Cosmetics, inter_threshold lavc option, BUGS and AUTHORS section rewritten.
diego
parents: 11671
diff changeset
5847 Please send mails about it to the MPlayer-DOCS mailing list.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
5848 .\" end of file