annotate DOCS/xml/en/usage.xml @ 16406:c2cd00bfa3c0

A few more details and grammar updates. patch by Corey Hickey <bugfood-ml -- at -- fatooh -- dot -- org>
author diego
date Tue, 06 Sep 2005 16:33:31 +0000
parents 21c16d991b81
children ba2b36441de7
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
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
23 <literal>}</literal>. It's useful with option <option>-loop</option>:
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>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
180 Don't forget to enable the repeat flag in <filename>.lircrc</filename> when
13873
89bbd098cfda slight grammar/wording/spelling/markup improvements
diego
parents: 13717
diff changeset
181 it makes sense (seek, volume, etc). Here's 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>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
214 If you don't like the standard location for the lirc-config file
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>
13903
1d27ba5adf1f redundant "Note:" removed
wight
parents: 13873
diff changeset
259 It's 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
9966
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
297 implemented at the demuxer level. It's 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
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
317 access. Currently the server is very basic and doesn't have any commands
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>
9aeb20839969 patch by Albeu, corrected by Diego Biurrun & me
nicolas
parents: 9675
diff changeset
333 Be aware that currently the server is not secure at all. So don't 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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
405 <title>Advanced Audio</title>
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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
408 <title>Surround/Multichannel Playback</title>
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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
436 <title>Playing Stereo Files to Four Speakers</title>
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>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
497 Note that there is a comma ("<keycap>,</keycap>") at the end of
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
499 <application>MPlayer</application> fall back to the codecs it normally uses when
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
500 playing a file that doesn't have AC3 or DTS audio. <option>afm=hwac3</option>
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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
509 <title>Matrix-encoded Audio</title>
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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
542 <title>Surround Emulation in Headphones</title>
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
546 Function) filter based on an MIT project wherein measurements were taken from
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
547 microphones mounted on a dummy human head. See the
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
548 <ulink url="http://sound.media.mit.edu/KEMAR.html">project page</ulink> for more
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
549 information.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
550 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
551
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
552 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
553 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
554 <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
555 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
556 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
557 generates subtle echoes, increases the stereo separation slightly, and alters
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
558 the volume of some frequencies. Whether HRTF sounds better may be dependant on
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
559 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
560 trying out.
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
561 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
562
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
563 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
564 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
565
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
566 <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
567
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
568 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
569
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
570 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
571 <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
572 <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
573 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
574 <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
575
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
576 <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
577
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
578 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
579
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
580 </sect3>
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
583 <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
584 <title>Troubleshooting</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
585
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
586 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
587 If you don't hear any sound out of your surround channels, check your mixer
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
588 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
589 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
590 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
591
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
592 </sect3>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
593
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
594 </sect2>
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
597 <sect2 id="advaudio-channels">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
598 <title>Channel Manipulation</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
599
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
600 <sect3 id="advaudio-channels-general">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
601 <title>General Information</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
602
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
603 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
604 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
605 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
606 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
607
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
608 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
609 <title>Mono</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
610 <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
611 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
612
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
613 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
614 <title>Stereo</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
615 <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
616 <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
617 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
618
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
619 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
620 <title>Quadraphonic</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
621 <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
622 <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
623 <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
624 <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
625 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
626
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
627 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
628 <title>Surround 4.0</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
629 <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
630 <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
631 <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
632 <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
633 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
634
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
635 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
636 <title>Surround 5.0</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
637 <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
638 <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
639 <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
640 <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
641 <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
642 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
643
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
644 <orderedlist spacing="compact">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
645 <title>Surround 5.1</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
646 <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
647 <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
648 <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
649 <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
650 <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
651 <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
652 </orderedlist>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
653
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
654 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
655
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
656 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
657 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
658 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
659 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
660 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
661 <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
662 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
663 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
664
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
665 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
666 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
667 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
668 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
669 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
670
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
671 </sect3>
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
674 <sect3 id="advaudio-channels-mono">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
675 <title>Playing Mono in Two Speakers</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
676
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
677 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
678 Mono sounds a lot better when played through two speakers -- especially when
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
679 using headphones. Audio files that truly have 1 channel are automatically played
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
680 in two speakers; unfortunately, most files with mono sound are actually encoded
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
681 as stereo with one channel silent. The easiest and most foolproof way to make
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
682 both speakers output the same audio is with the <option>extrastereo</option>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
683 filter:
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
684
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
685 <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
686
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
687 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
688
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
689 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
690 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
691 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
692 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
693 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
694 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
695 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
696
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
697 <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
698
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
699 </para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
700
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
701 </sect3>
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
704 <sect3 id="advaudio-channels-copying">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
705 <title>Channel Copying/Moving</title>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
706
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
707 <para>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
708 The <option>channels</option> filter can move any or all channels. Setting up all
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
709 the suboptions to channels can be complicated and takes a little care.
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>
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
741 Here's an example of another way to play one channel in both speakers. Suppose
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
756 suboption pair is "0:1". To move the left channel into itself is "0:0".
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
768 is in the right channel. Also, it's more difficult to remember and type.
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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
813 <title>Channel Mixing</title>
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
828 many channels are output.
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
842 <option>pan</option> with <option>,volume</option> to enable clipping, but it's
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
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
897 downmixing. Here's a way to downmix PCM using <option>pan</option>:
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">
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
997 <title>Software Volume Adjustment</title>
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,
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1020 since <application>MPlayer</application> adjusts volume by percentage of the
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
16391
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1038 sound card data that is outside the allowable range. You will hear distortion
7a5d36c0633b MPlayer advanced audio usage guide by Corey Hickey < bugfood-ml AH fatooh POUM org>
gpoirier
parents: 15506
diff changeset
1039 when this happens.
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>