annotate DOCS/xml/en/usage.xml @ 16487:bafefab46f12

minor wording fix in the advanced audio guide
author wanderer
date Wed, 14 Sep 2005 21:15:38 +0000
parents ba2b36441de7
children 68890ac57391
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
1 <?xml version="1.0" encoding="iso-8859-1"?>
10913
49b1a67e7381 Add revision keyword to english xml files, to ease translation synchronization
lumag
parents: 10755
diff changeset
2 <!-- $Revision$ -->
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
3 <chapter id="usage">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
4 <title>Usage</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
5
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
6 <sect1 id="commandline">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
7 <title>Command line</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
8
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
9 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
10 <application>MPlayer</application> utilizes a complex playtree. It consists
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
11 of global options written as first, for example
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
12
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
13 <screen>mplayer -vfm 5</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
14
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
15 and options written after filenames, that apply only to the given
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
16 filename/URL/whatever, for example:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
17
11737
0d5f9340f983 missing <replaceable> tag
paszczi
parents: 11713
diff changeset
18 <screen>mplayer -vfm 5 <replaceable>movie1.avi</replaceable> <replaceable>movie2.avi</replaceable> -vfm 4</screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
19 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
20
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
21 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
22 You can group filenames/URLs together using <literal>{</literal> and
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
23 <literal>}</literal>. It is useful with option <option>-loop</option>:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
24
10643
ec69923456d1 Fix '- loop' to '-loop' option into example
nauj27
parents: 10184
diff changeset
25 <screen>mplayer { 1.avi -loop 2 2.avi } -loop 3</screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
26
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
27 The above command will play files in this order: 1, 1, 2, 1, 1, 2, 1, 1, 2.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
28 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
29
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
30 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
31 Playing a file:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
32 <synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
33 <command>mplayer</command><!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
34 --> [<replaceable>options</replaceable>]<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
35 --> [<replaceable>path</replaceable>/]<replaceable>filename</replaceable>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
36 </synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
37 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
38
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
39 <para>
15463
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
40 Another way to play a file:
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
41 <synopsis>
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
42 <command>mplayer</command><!--
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
43 --> [<replaceable>options</replaceable>]<!--
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
44 --> <replaceable>file:///uri-escaped-path</replaceable>
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
45 </synopsis>
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
46 </para>
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
47
741b6a00782f Document new file:// syntax.
diego
parents: 14707
diff changeset
48 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
49 Playing more files:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
50 <synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
51 <command>mplayer</command><!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
52 --> [<replaceable>default options</replaceable>]<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
53 --> [<replaceable>path</replaceable>/]<replaceable>filename1</replaceable><!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
54 --> [<replaceable>options for filename1</replaceable>]<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
55 --> <replaceable>filename2</replaceable><!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
56 --> [<replaceable>options for filename2</replaceable>] ...
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
57 </synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
58 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
59
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
60 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
61 Playing VCD:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
62 <synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
63 <command>mplayer</command> [<replaceable>options</replaceable>]<!--
10184
b6c63ab184a4 Changed a few remaining -dvd and -vcd options to dvd:// and vcd://.
diego
parents: 10144
diff changeset
64 --> vcd://<replaceable>trackno</replaceable><!--
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
65 --> [-cdrom-device <replaceable>/dev/cdrom</replaceable>]
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
66 </synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
67 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
68
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
69 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
70 Playing DVD:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
71 <synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
72 <command>mplayer</command> [<replaceable>options</replaceable>]<!--
10184
b6c63ab184a4 Changed a few remaining -dvd and -vcd options to dvd:// and vcd://.
diego
parents: 10144
diff changeset
73 --> dvd://<replaceable>titleno</replaceable><!--
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
74 --> [-dvd-device <replaceable>/dev/dvd</replaceable>]
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
75 </synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
76 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
77
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
78 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
79 Playing from the WWW:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
80 <synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
81 <command>mplayer</command> [<replaceable>options</replaceable>]<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
82 --> http://<replaceable>site.com/file.asf</replaceable>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
83 </synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
84 (playlists can be used, too)
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
85 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
86
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
87 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
88 Playing from RTSP:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
89 <synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
90 <command>mplayer</command> [<replaceable>options</replaceable>]<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
91 --> rtsp://<replaceable>server.example.com/streamName</replaceable>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
92 </synopsis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
93 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
94
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
95 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
96 Examples:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
97 <screen>
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
98 mplayer -vo x11 <replaceable>/mnt/Films/Contact/contact2.mpg</replaceable>
12833
lumag
parents: 12615
diff changeset
99 mplayer vcd://<replaceable>2</replaceable> -cdrom-device <replaceable>/dev/hdc</replaceable>
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
100 mplayer -afm 3 <replaceable>/mnt/DVDtrailers/alien4.vob</replaceable>
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
101 mplayer dvd://<replaceable>1</replaceable> -dvd-device <replaceable>/dev/hdc</replaceable>
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
102 mplayer -abs 65536 -delay -0.4 -nobps <replaceable>~/movies/test.avi</replaceable><!--
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
103 --></screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
104 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
105 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
106
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
107
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
108 <sect1 id="control">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
109 <title>Control</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
110
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
111 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
112 <application>MPlayer</application> has a fully configurable, command
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
113 driven, control layer which lets you control
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
114 <application>MPlayer</application> with keyboard, mouse, joystick or remote
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
115 control (using LIRC). See the man page for the complete list of keyboard controls.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
116 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
117
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
118
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
119 <sect2 id="ctrl-cfg">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
120 <title>Controls configuration</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
121
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
122 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
123 <application>MPlayer</application> allows you bind any key/button to any
11540
d480f7e36b74 <application> attack
wight
parents: 11271
diff changeset
124 <application>MPlayer</application> command using a simple config file.
d480f7e36b74 <application> attack
wight
parents: 11271
diff changeset
125 The syntax consist of a key name followed by a command. The default config file location is
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
126 <filename>$HOME/.mplayer/input.conf</filename> but it can be overridden
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
127 using the <option>-input <replaceable>conf</replaceable></option> option
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
128 (relative path are relative to <filename>$HOME/.mplayer</filename>).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
129 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
130
13717
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
131 <para>
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
132 You can get a full list of supported key names by running
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
133 <command>mplayer -input keylist</command>
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
134 and a full list of available commands by running
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
135 <command>mplayer -input cmdlist</command>.
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
136 </para>
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
137
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
138 <example>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
139 <title>A simple input control file</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
140 <programlisting>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
141 ##
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
142 ## MPlayer input control file
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
143 ##
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
144
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
145 RIGHT seek +10
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
146 LEFT seek -10
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
147 - audio_delay 0.100
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
148 + audio_delay -0.100
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
149 q quit
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
150 &gt; pt_step 1
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
151 &lt; pt_step -1
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
152 ENTER pt_step 1 1<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
153 --></programlisting>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
154 </example>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
155 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
156
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
157
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
158 <sect2 id="lirc">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
159 <title>Control from LIRC</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
160
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
161 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
162 Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver,
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
163 an (almost) arbitrary remote control and control your Linux box with it!
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
164 More about it on the <ulink url="http://www.lirc.org">LIRC homepage</ulink>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
165 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
166
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
167 <para>
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
168 If you have the LIRC package installed, <filename>configure</filename> will
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
169 autodetect it. If everything went fine, <application>MPlayer</application>
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
170 will print &quot;<systemitem>Setting up LIRC support...</systemitem>&quot;
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
171 on startup. If an error occurs it will tell you. If there is no message about
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
172 LIRC there is no support compiled in. That's it :-)
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
173 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
174
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
175 <para>
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
176 The application name for <application>MPlayer</application> is - surprise -
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
177 <filename>mplayer</filename>. You can use any <application>MPlayer</application>
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
178 commands and even pass more than one command by separating them with
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
179 <literal>\n</literal>.
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
180 Do not forget to enable the repeat flag in <filename>.lircrc</filename> when
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
181 it makes sense (seek, volume, etc). Here is an excerpt from a sample
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
182 <filename>.lircrc</filename>:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
183 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
184
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
185 <programlisting>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
186 begin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
187 button = VOLUME_PLUS
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
188 prog = mplayer
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
189 config = volume 1
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
190 repeat = 1
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
191 end
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
192
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
193 begin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
194 button = VOLUME_MINUS
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
195 prog = mplayer
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
196 config = volume -1
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
197 repeat = 1
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
198 end
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
199
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
200 begin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
201 button = CD_PLAY
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
202 prog = mplayer
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
203 config = pause
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
204 end
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
205
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
206 begin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
207 button = CD_STOP
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
208 prog = mplayer
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
209 config = seek 0 1\npause
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
210 end<!--
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
211 --></programlisting>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
212
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
213 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
214 If you do not like the standard location for the lirc-config file
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
215 (<filename>~/.lircrc</filename>) use the <option>-lircconf
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
216 <replaceable>filename</replaceable></option> switch to specify another
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
217 file.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
218 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
219 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
220
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
221
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
222 <sect2 id="slave-mode">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
223 <title>Slave mode</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
224 <para>
13717
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
225 The slave mode allows you to build simple frontends to
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
226 <application>MPlayer</application>. When run with the
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
227 <option>-slave</option> option <application>MPlayer</application> will
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
228 read commands separated by a newline (\n) from stdin.
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
229 The commands are documented in the
10acb5e309e2 Remove incomplete key list and command list and update the other sections
diego
parents: 13710
diff changeset
230 <ulink url="../../tech/slave.txt">slave.txt</ulink> file.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
231 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
232 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
233 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
234
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
235
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
236 <sect1 id="streaming">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
237 <title>Streaming from network or pipes</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
238
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
239 <para>
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
240 <application>MPlayer</application> can play files from the network, using the
10755
diego
parents: 10643
diff changeset
241 HTTP, FTP, MMS or RTSP/RTP protocol.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
242 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
243
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
244 <para>
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
245 Playing works simply by passing the URL on the command line.
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
246 <application>MPlayer</application> honors the <envar>http_proxy</envar>
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
247 environment variable, using a proxy if available. Proxies can also be forced:
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
248 <screen>mplayer <replaceable>http_proxy://proxy.micorsops.com:3128/http://micorsops.com:80/stream.asf</replaceable></screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
249 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
250
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
251 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
252 <application>MPlayer</application> can read from stdin
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
253 (<emphasis>not</emphasis> named pipes). This can for example be used to
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
254 play from FTP:
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
255 <screen>wget <replaceable>ftp://micorsops.com/something.avi</replaceable> -O - | mplayer -</screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
256 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
257
11035
094e0838e5a7 <para>Note:.... </para> really should be <note><para>....</para></note>
lumag
parents: 10968
diff changeset
258 <note><para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
259 It is also recommended to enable <option>-cache</option> when playing
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
260 from the network:
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
261 <screen>wget <replaceable>ftp://micorsops.com/something.avi</replaceable> -O - | mplayer -cache 8192 -</screen>
11035
094e0838e5a7 <para>Note:.... </para> really should be <note><para>....</para></note>
lumag
parents: 10968
diff changeset
262 </para></note>
15499
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
263
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
264 <sect2 id="streaming-save">
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
265 <title>Saving streamed content</title>
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
266 <para>
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
267 Once you succeed in making <application>MPlayer</application> play
15506
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
268 your favorite internet stream, you can use the option
15499
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
269 <option>-dumpstream</option> to save the stream into a file.
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
270 For example:
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
271 <screen>
15506
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
272 mplayer <replaceable>http://217.71.208.37:8006</replaceable> -dumpstream -dumpfile <replaceable>stream.asf</replaceable>
15499
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
273 </screen>
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
274 will save the content streamed from
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
275 <replaceable>http://217.71.208.37:8006</replaceable> into
15506
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
276 <replaceable>stream.asf</replaceable>.
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
277 This works with all protocols supported by
15499
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
278 <application>MPlayer</application>, like MMS, RSTP, and so forth.
15506
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
279 If you only wish to save audio or video, use <option>-dumpaudio</option>
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
280 or <option>-dumpvideo</option> respectively, but be aware that
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
281 <application>MPlayer</application> will ignore all but the last
2b9a8966c53f Clarify that -dumpstream works for video as well as audio and mention
diego
parents: 15499
diff changeset
282 <option>-dump*</option> option given on the command line.
15499
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
283 </para>
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
284 </sect2>
4876278747dc Saving streamed content
gpoirier
parents: 15463
diff changeset
285
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
286 </sect1>
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
287
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
288 <sect1 id="mpst" xreflabel="Remote streams">
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
289 <title>Remote streams</title>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
290
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
291 <para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
292 Remote streams allow you to access most <application>MPlayer</application>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
293 stream type from a remote host. The main purpose of this feature is to make
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
294 it possible to directly use the CD or DVD drive of another computer on the
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
295 network (provided you have the required bandwidth). On the downside some
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 11143
diff changeset
296 stream type (currently TV and MF) are not usable remotely because they are
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
297 implemented at the demuxer level. It is sad for MF but TV stream would anyway
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 11143
diff changeset
298 require an insane amount of bandwidth.
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
299 </para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
300
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
301 <sect2 id="compile_mpst_server">
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
302 <title>Compiling the server</title>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
303 <para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
304 After having compiled <application>MPlayer</application> go to the
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
305 <filename>TOOLS/netstream</filename> directory and enter
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
306 <application>make</application> to build the server binary.
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
307 You can then copy the <application>netstream</application> binary
9969
nicolas
parents: 9966
diff changeset
308 to the right place on your system (usually
nicolas
parents: 9966
diff changeset
309 <filename class="directory">/usr/local/bin</filename> on Linux).
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
310 </para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
311 </sect2>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
312
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
313 <sect2 id="use_mpst">
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
314 <title>Using remote streams</title>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
315 <para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
316 First you have to start the server on the computer you intend to remotely
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
317 access. Currently the server is very basic and does not have any commands
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
318 line arguments so just enter <filename>netstream</filename>. Now you can
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
319 for example play the second track of a VCD on the server with :
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
320 <screen>
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
321 mplayer -cache 5000 <replaceable>mpst://servername/vcd://2</replaceable>
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
322 </screen>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
323 You can also access files on this server :
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
324 <screen>
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11542
diff changeset
325 mplayer -cache 5000 <replaceable>mpst://servername//usr/local/movies/lol.avi</replaceable>
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
326 </screen>
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 11143
diff changeset
327 Note that paths which aren't starting with a / will be relative to
11143
ebf702420f9b Add some missing <option> tags, patch by Torinthiel.
diego
parents: 11035
diff changeset
328 the directory where the server is running. The <option>-cache</option> option is not
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
329 needed but highly recommended.
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
330 </para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
331
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
332 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
333 Be aware that currently the server is not secure at all. So do not complain
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 11143
diff changeset
334 about the numerous exploits which are possible through this. Instead send
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
335 some (good) patch to make it better or start writing your own server.
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
336 </para>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
337
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
338 </sect2>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
339
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
340 </sect1>
11786
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
341
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
342 <sect1 id="edl" xreflabel="Edit Decision Lists (EDL)">
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
343 <title>Edit Decision Lists (EDL)</title>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
344
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
345 <para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
346 The edit decision list (EDL) system allows you to automatically skip
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
347 or mute sections of videos during playback, based on a movie specific
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
348 EDL configuration file.
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
349 </para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
350
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
351 <para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
352 This is useful for those who may want to watch a film in "family-friendly"
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
353 mode. You can cut out any violence, profanity, Jar-Jar Binks .. from a movie
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
354 according to your own personal preferences. Aside from this, there are other
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
355 uses, like automatically skipping over commercials in video files you watch.
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
356 </para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
357
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
358 <para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
359 The EDL file format is pretty bare-bones. Once the EDL system has reached a
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
360 certain level of maturity, an XML-based file format will probably be implemented
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
361 (keeping backwards compatibility with previous EDL formats).
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
362 </para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
363
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
364 <sect2 id="edl_using">
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
365 <title>Using an EDL file</title>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
366 <para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
367 Include the <option>-edl &lt;filename&gt;</option> flag when you run
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
368 <application>MPlayer</application>, with the name of the EDL file you
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
369 want applied to the video.
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
370 </para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
371 </sect2>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
372
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
373 <sect2 id="edl_making">
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
374 <title>Making an EDL file</title>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
375 <para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
376 The current EDL file format is:
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
377 <programlisting>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
378 [begin second] [end second] [action]
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
379 </programlisting>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
380 Where the seconds are floating-point numbers and the action is either
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
381 <literal>0</literal> for skip or <literal>1</literal> for mute. Example:
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
382 <programlisting>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
383 5.3 7.1 0
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
384 15 16.7 1
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
385 420 422 0
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
386 </programlisting>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
387 This will skip from second 5.3 to second 7.1 of the video, then mute at
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
388 15 seconds, unmute at 16.7 seconds and skip from second 420 to second 422
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
389 of the video. These actions will be performed when the playback timer
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
390 reaches the times given in the file.
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
391 </para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
392
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
393 <para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
394 To create an EDL file to work from, use the <option>-edlout &lt;filename&gt;</option>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
395 flag. During playback, when you want to mark the previous two seconds to skip over,
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
396 hit <keycap>i</keycap>. A corresponding entry will be written to the file for
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
397 that time. You can then go back and fine-tune the generated EDL file.
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
398 </para>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
399 </sect2>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
400
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
401 </sect1>
06474b60be53 EDL section moved into usage.
diego
parents: 11737
diff changeset
402
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
403
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
404 <sect1 id="advaudio" xreflabel="Advanced Audio">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
405 <title>Advanced audio</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
406
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
407 <sect2 id="advaudio-surround">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
408 <title>Surround/Multichannel playback</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
409
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
410 <sect3 id="advaudio-surround-DVD">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
411 <title>DVDs</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
412 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
413 Most DVDs and many other files include surround sound.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
414 <application>MPlayer</application> supports surround playback but does not
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
415 enable it by default because stereo equipment is by far more common. To play a
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
416 file that has more than two channels of audio use <option>-channels</option>.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
417 For example, to play a DVD with 5.1 audio:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
418
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
419 <screen>mplayer dvd://1 -channels 6</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
420
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
421 Note that despite the name "5.1" there are actually six discrete channels.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
422 If you have surround sound equipment it is safe to put the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
423 <option>channels</option> option in your <application>MPlayer</application>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
424 configuration file <filename>~/.mplayer/config</filename>. For example, to make
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
425 quadraphonic playback the default, add this line:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
426
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
427 <programlisting>channels=4</programlisting>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
428
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
429 <application>MPlayer</application> will then output audio in four channels when
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
430 all four channels are available.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
431 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
432 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
433
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
434
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
435 <sect3 id="advaudio-surround-stereoinfour">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
436 <title>Playing stereo files to four speakers</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
437
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
438 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
439 <application>MPlayer</application> does not duplicate any channels by default,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
440 and neither do most audio drivers. If you want to do that manually:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
441
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
442 <screen>mplayer <replaceable>filename</replaceable> -af channels=2:2:0:1:0:0</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
443
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
444 See the section on
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
445 <link linkend="advaudio-channels-copying">channel copying</link> for an
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
446 explanation.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
447 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
448
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
449 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
450
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
451
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
452 <sect3 id="advaudio-surround-passthrough">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
453 <title>AC3/DTS Passthrough</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
454
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
455 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
456 DVDs usually have surround audio encoded in AC3 (Dolby Digital) or DTS
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
457 (Digital Theater System) format. Some modern audio equipment is capable of
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
458 decoding these formats internally. <application>MPlayer</application> can be
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
459 configured to relay the audio data without decoding it. This will only work if
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
460 you have a S/PDIF (Sony/Philips Digital Interface) jack in your sound card.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
461 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
462
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
463 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
464 If your audio equipment can decode both AC3 and DTS, you can safely enable
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
465 passthrough for both formats. Otherwise, enable passthrough for only the format
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
466 your equipment supports.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
467 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
468
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
469 <itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
470 <title>To enable passthrough on the command line:</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
471 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
472 For AC3 only, use <option>-ac hwac3</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
473 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
474 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
475 For DTS only, use <option>-ac hwdts</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
476 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
477 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
478 For both AC3 and DTS, use <option>-afm hwac3</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
479 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
480 </itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
481
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
482 <itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
483 <title>To enable passthrough in the <application>MPlayer</application>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
484 configuration file: </title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
485 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
486 For AC3 only, use <option>ac=hwac3,</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
487 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
488 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
489 For DTS only, use <option>ac=hwdts,</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
490 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
491 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
492 For both AC3 and DTS, use <option>-afm hwac3</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
493 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
494 </itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
495
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
496 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
497 Note that there is a comma (",") at the end of
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
498 <option>ac=hwac3,</option> and <option>ac=hwdts,</option>. This will make
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
499 <application>MPlayer</application> fall back on the codecs it normally uses when
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
500 playing a file that does not have AC3 or DTS audio. <option>afm=hwac3</option>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
501 does not need a comma; <application>MPlayer</application> will fall back anyway
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
502 when an audio family is specified.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
503 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
504
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
505 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
506
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
507
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
508 <sect3 id="advaudio-surround-matrix">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
509 <title>Matrix-encoded audio</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
510
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
511 <para>
16394
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
512 <emphasis>***TODO***</emphasis>
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
513 </para>
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
514 <para>
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
515 This section has yet to be written and cannot be completed until somebody
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
516 provides sample files for us to test. If you have any matrix-encoded audio
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
517 files, know where to find some, or have any information that could be helpful,
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
518 please send a message to the
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
519 <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-docs">MPlayer-DOCS</ulink>
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
520 mailing list. Put "[matrix-encoded audio]" in the subject line.
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
521 </para>
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
522 <para>
21c16d991b81 rewrite the little we-want-matrix-files section, patch by Corey Hickey < bugfood-ml AT fatooh DOT org >
wanderer
parents: 16391
diff changeset
523 If no files or further information are forthcoming this section will be dropped.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
524 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
525
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
526 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
527 Good links:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
528 <itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
529 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
530 <ulink url="http://electronics.howstuffworks.com/surround-sound5.htm">http://electronics.howstuffworks.com/surround-sound5.htm</ulink>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
531 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
532 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
533 <ulink url="http://www.extremetech.com/article2/0,1697,1016875,00.asp">http://www.extremetech.com/article2/0,1697,1016875,00.asp</ulink>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
534 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
535 </itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
536 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
537
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
538 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
539
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
540
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
541 <sect3 id="advaudio-surround-hrtf">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
542 <title>Surround emulation in headphones</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
543
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
544 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
545 <application>MPlayer</application> includes an HRTF (Head Related Transfer
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
546 Function) filter based on an
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
547 <ulink url="http://sound.media.mit.edu/KEMAR.html">MIT project</ulink>
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
548 wherein measurements were taken from microphones mounted on a dummy human head.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
549 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
550
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
551 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
552 Although it is not possible to exactly imitate a surround system,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
553 <application>MPlayer</application>'s HRTF filter does provide more spatially
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
554 immersive audio in 2-channel headphones. Regular downmixing simply combines all
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
555 the channels into two; besides combining the channels, <option>hrtf</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
556 generates subtle echoes, increases the stereo separation slightly, and alters
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
557 the volume of some frequencies. Whether HRTF sounds better may be dependent on
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
558 the source audio and a matter of personal taste, but it is definitely worth
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
559 trying out.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
560 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
561
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
562 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
563 To play a DVD with HRTF:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
564
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
565 <screen>mplayer dvd://1 -channels 6 -af hrtf</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
566
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
567 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
568
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
569 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
570 <option>hrtf</option> only works well with 5 or 6 channels. Also,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
571 <option>hrtf</option> requires 48 kHz audio. DVD audio is already 48 kHz, but if
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
572 you have a file with a different sampling rate that you want to play using
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
573 <option>hrtf</option> you must resample it:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
574
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
575 <screen>mplayer <replaceable>filename</replaceable> -channels 6 -af resample=48000,hrtf</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
576
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
577 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
578
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
579 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
580
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
581
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
582 <sect3 id="advaudio-surround-troubleshooting">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
583 <title>Troubleshooting</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
584
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
585 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
586 If you do not hear any sound out of your surround channels, check your mixer
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
587 settings with a mixer program such as <application>alsamixer</application>;
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
588 audio outputs are often muted and set to zero volume by default.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
589 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
590
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
591 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
592
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
593 </sect2>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
594
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
595
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
596 <sect2 id="advaudio-channels">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
597 <title>Channel manipulation</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
598
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
599 <sect3 id="advaudio-channels-general">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
600 <title>General information</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
601
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
602 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
603 Unfortunately, there is no standard for how channels are ordered. The orders
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
604 listed below are those of AC3 and are fairly typical; try them and see if your
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
605 source matches. Channels are numbered starting with 0.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
606
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
607 <orderedlist spacing="compact">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
608 <title>mono</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
609 <listitem override="0"><simpara>center</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
610 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
611
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
612 <orderedlist spacing="compact">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
613 <title>stereo</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
614 <listitem override="0"><simpara>left</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
615 <listitem><simpara>right</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
616 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
617
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
618 <orderedlist spacing="compact">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
619 <title>quadraphonic</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
620 <listitem override="0"><simpara>left front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
621 <listitem><simpara>right front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
622 <listitem><simpara>left rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
623 <listitem><simpara>right rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
624 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
625
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
626 <orderedlist spacing="compact">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
627 <title>surround 4.0</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
628 <listitem override="0"><simpara>left front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
629 <listitem><simpara>right front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
630 <listitem><simpara>center rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
631 <listitem><simpara>center front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
632 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
633
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
634 <orderedlist spacing="compact">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
635 <title>surround 5.0</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
636 <listitem override="0"><simpara>left front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
637 <listitem><simpara>right front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
638 <listitem><simpara>left rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
639 <listitem><simpara>right rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
640 <listitem><simpara>center front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
641 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
642
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
643 <orderedlist spacing="compact">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
644 <title>surround 5.1</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
645 <listitem override="0"><simpara>left front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
646 <listitem><simpara>right front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
647 <listitem><simpara>left rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
648 <listitem><simpara>right rear</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
649 <listitem><simpara>center front</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
650 <listitem><simpara>subwoofer</simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
651 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
652
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
653 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
654
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
655 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
656 The <option>-channels</option> option is used to request the number of
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
657 channels from the audio decoder. Some audio codecs use the number of specified
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
658 channels to decide if downmixing the source is necessary. Note that this does
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
659 not always affect the number of output channels. For example, using
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
660 <option>-channels 4</option> to play a stereo MP3 file will still result in
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
661 2-channel output since the MP3 codec will not produce the extra channels.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
662 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
663
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
664 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
665 The <option>channels</option> audio filter can be used to create or remove
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
666 channels and is useful for controlling the number of channels sent to the sound
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
667 card. See the following sections for more information on channel manipulation.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
668 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
669
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
670 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
671
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
672
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
673 <sect3 id="advaudio-channels-mono">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
674 <title>Playing mono with two speakers</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
675
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
676 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
677 Mono sounds a lot better when played through two speakers - especially when
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
678 using headphones. Audio files that truly have one channel are automatically
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
679 played through two speakers; unfortunately, most files with mono sound are
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
680 actually encoded as stereo with one channel silent. The easiest and most
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
681 foolproof way to make both speakers output the same audio is the
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
682 <option>extrastereo</option> filter:
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
683
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
684 <screen>mplayer <replaceable>filename</replaceable> -af extrastereo=0</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
685
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
686 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
687
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
688 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
689 This averages both channels, resulting in both channels being half as loud as
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
690 the original. The next sections have examples of other ways to do this without a
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
691 volume decrease, but they are more complex and require different options
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
692 depending on which channel to keep. If you really need to maintain the volume,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
693 it may be easier to experiment with the <option>volume</option> filter and find
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
694 the right value. For example:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
695
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
696 <screen>mplayer <replaceable>filename</replaceable> -af extrastereo=0,volume=5</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
697
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
698 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
699
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
700 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
701
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
702
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
703 <sect3 id="advaudio-channels-copying">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
704 <title>Channel copying/moving</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
705
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
706 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
707 The <option>channels</option> filter can move any or all channels.
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
708 Setting up all the suboptions for the <option>channels</option>
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
709 filter can be complicated and takes a little care.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
710
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
711 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
712 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
713 Decide how many output channels you need. This is the first suboption.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
714 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
715 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
716 Count how many channel moves you will do. This is the second suboption. Each
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
717 channel can be moved to several different channels at the same time, but keep in
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
718 mind that when a channel is moved (even if to only one destination) the source
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
719 channel will be empty unless another channel is moved into it. To copy a
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
720 channel, keeping the source the same, simply move the channel into both the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
721 destination and the source. For example:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
722 <programlisting>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
723 channel 2 --> channel 3
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
724 channel 2 --> channel 2
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
725 </programlisting>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
726 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
727 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
728 Write out the channel copies as pairs of suboptions. Note that the first channel
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
729 is 0, the second is 1, etc. The order of these suboptions does not matter as
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
730 long as they are properly grouped into
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
731 <replaceable>source:destination</replaceable> pairs.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
732 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
733 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
734
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
735 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
736
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
737
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
738 <bridgehead>Example: one channel in two speakers</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
739
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
740 <para>
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
741 Here is an example of another way to play one channel in both speakers. Suppose
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
742 for this example that the left channel should be played and the right channel
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
743 discarded. Following the steps above:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
744 <orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
745 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
746 In order to provide an output channel for each of the two speakers, the first
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
747 suboption must be "2".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
748 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
749 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
750 The left channel needs to be moved to the right channel, and also must be moved
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
751 to itself so it won't be empty. This is a total of two moves, making the second
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
752 suboption "2" as well.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
753 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
754 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
755 To move the left channel (channel 0) into the right channel (channel 1), the
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
756 suboption pair is "0:1", "0:0" moves the left channel onto itself.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
757 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
758 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
759 Putting that all together gives:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
760
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
761 <screen>mplayer <replaceable>filename</replaceable> -af channels=2:2:0:1:0:0</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
762 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
763
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
764 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
765 The advantage this example has over <option>extrastereo</option> is that the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
766 volume of each output channel is the same as the input channel. The disadvantage
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
767 is that the suboptions must be changed to "2:2:1:0:1:1" when the desired audio
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
768 is in the right channel. Also, it is more difficult to remember and type.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
769 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
770
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
771 <bridgehead>Example: left channel in two speakers shortcut</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
772
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
773 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
774 There is actually a much easier way to use the <option>channels</option> filter
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
775 for playing the left channel in both speakers:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
776
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
777 <screen>mplayer <replaceable>filename</replaceable> -af channels=1</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
778
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
779 The second channel is discarded and, with no further suboptions, the single
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
780 remaining channel is left alone. Sound card drivers automatically play
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
781 single-channel audio in both speakers. This only works when the desired channel
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
782 is on the left.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
783 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
784
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
785 <bridgehead>Example: duplicate front channels to the rear</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
786 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
787 Another common operation is to duplicate the front channels and play them back
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
788 on the rear speakers of a quadraphonic setup.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
789 <orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
790 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
791 There should be four output channels. The first suboption is "4".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
792 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
793 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
794 Each of the two front channels needs to be moved to the corresponding rear
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
795 channel and also to itself. This is four moves, so the second suboption is "4".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
796 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
797 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
798 The left front (channel 0) needs to moved to the left rear (channel 2): "0:2".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
799 The left front also needs to be moved to itself: "0:0". The right front (channel
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
800 1) is moved to the right rear (channel 3): "1:3", and also to itself: "1:1".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
801 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
802 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
803 Combine all the suboptions to get:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
804
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
805 <screen>mplayer <replaceable>filename</replaceable> -af channels=4:4:0:2:0:0:1:3:1:1</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
806
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
807 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
808
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
809 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
810
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
811
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
812 <sect3 id="advaudio-channels-mixing">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
813 <title>Channel mixing</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
814
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
815 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
816 The <option>pan</option> filter can mix channels in user-specified proportions.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
817 This allows for everything the <option>channels</option> filter can do and
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
818 more. Unfortunately, the suboptions are much more complicated.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
819 <orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
820 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
821 Decide how many channels to work with. You may need to specify this with
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
822 <option>-channels</option> and/or <option>-af channels</option>. Later examples
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
823 will show when to use which.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
824 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
825 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
826 Decide how many channels to feed into <option>pan</option> (further decoded
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
827 channels are discarded). This is the first suboption, and it also controls how
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
828 many channels to employ for output.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
829 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
830 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
831 The remaining suboptions specify how much of each channel gets mixed into each
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
832 other channel. This is the complicated part. To break the task down, split the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
833 suboptions into several sets, one set for each output channel. Each suboption
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
834 within a set corresponds to an input channel. The number you specify will be the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
835 percentage of the input channel that gets mixed into the output channel.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
836 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
837 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
838 <option>pan</option> accepts values from 0 to 512, yielding 0% to 51200% of the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
839 original volume. Be careful when using values greater than 1. Not only can this
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
840 give you very high volume, but if you exceed the sample range of your sound card
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
841 you may hear painful pops and clicks. If you want you can follow
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
842 <option>pan</option> with <option>,volume</option> to enable clipping, but it is
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
843 best to keep the values of <option>pan</option> low enough that clipping is not
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
844 necessary.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
845 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
846 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
847 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
848
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
849 <bridgehead>Example: one channel in two speakers</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
850
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
851 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
852 Here is yet another example for playing the left channel in two speakers. Follow
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
853 the steps above:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
854 <orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
855 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
856 The number of output channels is 2. Since this is the same as the number of
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
857 channels in the input file, neither <option>-channels</option> nor
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
858 <option>-af channels</option> needs to be specified.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
859 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
860 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
861 <option>pan</option> should receive and output two channels, so the first
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
862 suboption is "2".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
863 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
864 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
865 Since we have two output channels, there will be two sets of suboptions. Since
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
866 there are also two input channels, there will be two suboptions per set. The
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
867 left channel should consist of 100% of itself and 0% of the right channel. So,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
868 the first set of suboptions is "1:0". The right channel should be 100% of the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
869 left channel and 0% of itself. This is "1:0" as well.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
870 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
871 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
872 Putting those options together gives:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
873
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
874 <screen>mplayer <replaceable>filename</replaceable> -af pan=2:1:0:1:0</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
875
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
876 If the right channel is desired instead of the left, the suboptions to
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
877 <option>pan</option> will be "2:0:1:0:1".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
878 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
879
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
880
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
881 <bridgehead>Example: left channel in two speakers shortcut</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
882
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
883 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
884 As with <option>channels</option>, there is a shortcut that only works with the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
885 left channel:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
886
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
887 <screen>mplayer <replaceable>filename</replaceable> -af pan=1:1</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
888
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
889 Since <option>pan</option> has only one channel of input (the other channel is
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
890 discarded), there is only one set with one suboption, which specifies that the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
891 only channel gets 100% of itself.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
892 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
893
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
894 <bridgehead>Example: downmixing 6-channel PCM</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
895 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
896 <application>MPlayer</application>'s decoder for 6-channel PCM is not capable of
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
897 downmixing. Here is a way to downmix PCM using <option>pan</option>:
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
898 <orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
899 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
900 The number of output channels is 2. Since <option>pan</option> will be handling
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
901 6 channels, it may be necessary to put <option>,channels=2</option> after pan to
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
902 get rid of the extra channels. If your sound card is capable of 6-channel
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
903 playback you can skip this, as the discarded channels will be empty by then anyway.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
904 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
905 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
906 <option>Pan</option> must receive all six channels to downmix, so the first
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
907 suboption is "6".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
908 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
909 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
910 With six input channels there will be six suboptions per set. Fortunately,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
911 since we only care about the output of the first two channels, we only need to
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
912 make two sets; the remaining four sets can be omitted. Beware that not all
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
913 multichannel audio files have the same channel order! This example
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
914 demonstrates downmixing a file with the same channels as AC3 5.1:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
915 <programlisting>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
916 0 - front left
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
917 1 - front right
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
918 2 - rear left
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
919 3 - rear right
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
920 4 - center front
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
921 5 - subwoofer
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
922 </programlisting>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
923 The first set of suboptions lists the percentages of the original volume, in
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
924 order, at which each channel listed above should be mixed into the front left
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
925 channel: "1:0:1:0:0.5:1". For the front right channel, this is "0:1:0:1:0.5:1".
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
926 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
927 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
928 Put all that together, for:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
929
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
930 <screen>mplayer <replaceable>6-channel.wav</replaceable> -af pan=6:1:0:1:0:0.5:1:0:1:0:1:0.5:1,channels=2</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
931
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
932 The percentages listed above are only a rough example. Feel free to tweak them.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
933 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
934
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
935 <bridgehead>Example: Playing 5.1 audio on big speakers without a subwoofer</bridgehead>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
936
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
937 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
938 If you have a huge pair of front speakers you may not want to waste any money on
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
939 buying a subwoofer for a complete 5.1 sound system. If you use
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
940 <option>-channels 5</option> to request that liba52 decode 5.1 audio in 5.0,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
941 the subwoofer channel is simply discarded. If you want to distribute the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
942 subwoofer channel yourself you need to downmix manually with
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
943 <option>pan</option>:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
944
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
945 <orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
946 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
947 Since <option>pan</option> needs to examine all six channels, specify
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
948 <option>-channels 6</option> so liba52 decodes them all.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
949 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
950 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
951 <option>pan</option> needs all the channels, so the first suboption is 6 as
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
952 well.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
953 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
954 <listitem><para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
955 Since the subwoofer channel is the last of six, we can specify five sets of
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
956 suboptions and omit the set belonging to the subwoofer channel. Each of those
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
957 five sets needs six suboptions so the list will get pretty long.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
958 <itemizedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
959 <listitem><simpara>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
960 The left front channel should have itself and half the subwoofer channel:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
961 "1:0:0:0:0:0.5"
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
962 </simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
963 <listitem><simpara>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
964 The right front channel should have itself and half the subwoofer channel:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
965 "0:1:0:0:0:0.5"
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
966 </simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
967 <listitem><simpara>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
968 The left rear channel stays the same:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
969 "0:0:1:0:0:0"
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
970 </simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
971 <listitem><simpara>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
972 The right rear channel stays the same:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
973 "0:0:0:1:0:0"
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
974 </simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
975 <listitem><simpara>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
976 The center front channel stays the same:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
977 "0:0:0:0:1:0"
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
978 </simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
979 <listitem><simpara>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
980 The subwoofer channel is left out and it will be silent.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
981 </simpara></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
982 </itemizedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
983 </para></listitem>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
984 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
985 Combine all those options to get:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
986
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
987 <screen>mplayer <replaceable>dvd://1</replaceable> -channels 6 -af pan=6:1:0:0:0:0:0.5:0:1:0:0:0:0.5:0:0:1:0:0:0:0:0:0:1:0:0:0:0:0:0:1:0</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
988
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
989 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
990
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
991 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
992
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
993 </sect2>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
994
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
995
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
996 <sect2 id="advaudio-volume">
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
997 <title>Software Volume adjustment</title>
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
998
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
999 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1000 Some audio tracks are too quiet to be heard comfortably without amplification.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1001 This becomes a problem when your audio equipment cannot amplify the signal for
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1002 you. The <option>-softvol</option> option directs
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1003 <application>MPlayer</application> to use an internal mixer. You can then use
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1004 the volume adjustment keys (by default <keycap>9</keycap> and
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1005 <keycap>0</keycap>) to reach much higher volume levels. Note that this does not
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1006 bypass your sound card's mixer; <application>MPlayer</application> only
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1007 amplifies the signal before sending it to your sound card.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1008
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1009 The following example is a good start:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1010
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1011 <screen>mplayer <replaceable>quiet-file</replaceable> -softvol -softvol-max 300</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1012
16406
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1013 The <option>-softvol-max</option> option specifies the maximum allowable output
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1014 volume as a percentage of the
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1015 original volume. For example, <option>-softvol-max 200</option> would allow the
16406
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1016 volume to be adjusted up to twice its original level.
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1017 It is safe to specify a large value with
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1018 <option>-softvol-max</option>; the higher volume will not be used until you
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1019 use the volume adjustment keys. The only disadvantage of a large value is that,
16407
ba2b36441de7 Avoid some short forms, some consistency, wording and typo fixes.
diego
parents: 16406
diff changeset
1020 since <application>MPlayer</application> adjusts volume by a percentage of the
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1021 maximum, you will not have as precise control when using the volume adjustment
16406
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1022 keys. Use a lower value with <option>-softvol-max</option> and/or specify
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1023 <option>-volstep 1</option> if you need higher precision.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1024 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1025
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1026 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1027 The <option>-softvol</option> option works by controlling the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1028 <option>volume</option> audio filter. If you want to play a file at a certain
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1029 volume from the beginning you can specify <option>volume</option> manually:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1030
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1031 <screen>mplayer <replaceable>quiet-file</replaceable> -af volume=10</screen>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1032
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1033 This will play the file with a ten decibel gain. Be careful when using the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1034 <option>volume</option> filter - you could easily hurt your ears if you use
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1035 too high a value. Start low and work your way up gradually until you get a feel
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1036 for how much adjustment is required. Also, if you specify excessively high
16406
c2cd00bfa3c0 A few more details and grammar updates.
diego
parents: 16394
diff changeset
1037 values, <option>volume</option> may need to clip the signal to avoid sending your
16487
bafefab46f12 minor wording fix in the advanced audio guide
wanderer
parents: 16407
diff changeset
1038 sound card data that is outside the allowable range; this will result in
bafefab46f12 minor wording fix in the advanced audio guide
wanderer
parents: 16407
diff changeset
1039 distorted audio.
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1040 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1041
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1042 </sect2>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1043
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1044 </sect1>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1045
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
1046 </chapter>