view DOCS/xml/pl/audio.xml @ 11423:dffc970f1922

FIXING A/V SYNC WHEN ENCODING, from an old mail by Rich: http://mplayerhq.hu/pipermail/mplayer-users/2002-July/018339.html
author diego
date Mon, 10 Nov 2003 10:12:35 +0000 (2003-11-10)
parents 20f205d23141
children 7cce7a837481
line wrap: on
line source
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- synced with 1.10  -->
<sect2 id="audio-dev">
<title>Urz�dzenia wyj�ciowe audio</title>
<sect3 id="sync">
<title>Synchronizacja Audio/Video</title>


<para>
Interfejs audio <application>MPlayera</application> nazywany jest
<emphasis>libao2</emphasis>. Obecnie zawiera nast�puj�ce sterowniki:
</para>

<informaltable>
<tgroup cols="2">
<thead>
  <row><entry>Sterownik</entry><entry>Komentarz</entry></row>
</thead>
<tbody>
<row><entry>oss</entry><entry>
  sterownik OSS (ioctl, sprz�towa obs�uga AC3)
  </entry></row>
<row><entry>sdl</entry><entry>
  sterownik SDL (obs�uguje takie demony d�wi�ku jak: <emphasis role="bold">ESD</emphasis>
  i <emphasis role="bold">ARTS</emphasis>)
  </entry></row>
<row><entry>nas</entry><entry>
  sterownik NAS (Network Audio System)
  </entry></row>
<row><entry>alsa5</entry><entry>
  rdzenny sterownik ALSA 0.5 
  </entry></row>
<row><entry>alsa9</entry><entry>
  rdzenny sterownik ALSA 0.9 (sprz�towa obs�uga AC3)
  </entry></row>
<row><entry>sun</entry><entry>
  rdzenny sterownik d�wi�ku SUN (<filename>/dev/audio</filename>) dla u�ytkownik�w 
  BSD Solarisa 8
  </entry></row>
<row><entry>macosx</entry><entry>
  rdzenny sterownik MacOSX
  </entry></row>
<row><entry>win32</entry><entry>
  rdzenny sterownik Win32
  </entry></row>
<row><entry>arts</entry><entry>
  rdzenny sterownik ARTS (g鞄wnie dla u�ytkownik�w KDE)
  </entry></row>
<row><entry>esd</entry><entry>
  rdzenny sterownik ESD (g鞄wnie dla u�ytkownik�w GNOMEa)
  </entry></row>
</tbody>
</tgroup>
</informaltable>

<para>
Sterowniki kart d�wi�kowych przeznaczone dla Linuksa, maj� problemy 
zwi�zane z kompatybilno�ci�. Dzieje si� tak, poniewa� <application>MPlayer</application> 
korzysta z wbudowanych w�a�ciwo�ci <emphasis>poprawnie</emphasis> napisanych 
sterownik�w d�wi�ku, kt�re prawid�owo obs�uguj� synchronizacj� audio/video.
Niestety, niekt�rzy autorzy sterownik�w nie uwzgl�dniaj� tej cechy, poniewa�
nie jest ona potrzebna do odtwarzania efekt�w d�wi�kowych i plik�w MP3. 
</para>

<para>
Inne odtwarzacze, takie jak: <ulink url="http://avifile.sourceforge.net">aviplay</ulink>
czy <ulink url="http://xine.sourceforge.net">xine</ulink> prawdopodobnie dzia�aj� 
od razu z tymi sterownikami, poniewa� u�ywaj� "prostych" metod synchronizacji 
korzystaj�cych z wewn�trznego zegara. Testy pokaza�y, �e ich metody nie s� tak
wydajne jak <application>MPlayera</application>.
</para>


<para>
U�ywanie <application>MPlayera</application> z poprawnie napisanym sterownikiem 
d�wi�ku, nigdy nie zaowocuje desynchronizacj� A/V z powodu d�wi�ku, poza bardzo �le
stworzonymi plikami (sprawd� stron� man dla rozwi�za� tego problemu).
</para>

<para>
Je�li zdarzy si� tak, �e posiadasz z�y sterownik d�wi�ku, spr�buj opcji 
<option>-autosync</option>, powinno to rozwi�za� Tw�j problem. Sprawd�
strony man dla dok�adniejszych informacji.
</para>

<itemizedlist>
<title>Kilka uwag:</title>
<listitem><para>
  Je�li posiadasz sterownik OSS, spr�buj najpierw opcji <option>-ao oss</option>
  (domy�lna). Je�eli zauwa�ysz niestabilne dzia�anie systemu, jego ci�g�e 
  zawieszenia si� lub inne dziwne zachowanie, wypr�buj <option>-ao sdl</option>
  (UWAGA: potrzebujesz zainstalowanych bibliotek i plik�w nag鞄wkowych SDL). 
  Sterownik SDL pomaga w wielu wypadkach, a tak�e obs�uguje ESD (GNOME) i ARTS (KDE).
  </para></listitem>
<listitem><para>
  Je�eli posiadasz sterowniki ALSA w wersji 0.5, wtedy prawie zawsze b�dziesz musia� 
  u�y� <option>-ao alsa5</option>, poniewa� posiadaj� one wadliwy kod emulacji OSS i
  spowoduje <emphasis role="bold">b咳d <application>MPlayera</application></emphasis>
  wy�wietlaj�c komunikat o podobnej tre�ci, jak ta:
  <screen>
    DEMUXER: Za du�o (945 w 8390980 bajtach) pakiet�w video w buforze!
    (DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!)<!--
--></screen>
  </para></listitem>
<listitem><para>
  Na Solarisie u�ywaj sterownika SUN poprzez opcj� <option>-ao sun</option>,
  w przeciwnym wypadku ani video, ani audio nie b�d� dzia�a�y.
  </para></listitem>
<listitem><para>
  Je�li d�wi�k przerywany jest kr�tkimi trzaskami podczas odtwarzania  z CD-ROMu, 
  w咳cz odmaskowanie IRQ, wpisuj�c np. <command>hdparm -u1 /dev/cdrom</command> 
  (<command>man hdparm</command>). Jest to bardzo przydatne i opisane bardziej 
  szczeg鶻owo w <link linkend="drives">sekcji dotycz�cej CD-ROMu</link>.
 </para></listitem>
</itemizedlist>
</sect3>

<sect3 id="experiences">
<title>Do�wiadczenia zwi�zane z u�ytkowaniem kart d�wi�kowych, zalecenia</title>
<para>
Przy stosowaniu Linuksa, zalecamy j�dro z serii 2.4.x . J�dro w wersji 2.2 nie by�o
testowane.
</para>

<para>
Sterowniki kart d�wi�kowych u�ywane w Linuksie s� g鞄wnie dostarczane przez 
woln� wersj� OSS. Wypierane s� one przez system
<ulink url="http://www.alsa-project.org">ALSA</ulink>
(Advanced Linux Sound Architecture) w wersji rozwojowej j�dra 2.5. Je�eli Twoja
dystrybucja nie u�ywa ALSA, mo�esz j� wypr�bowa�, je�eli b�dziesz mia� jakie� 
k�opoty z d�wi�kiem. ALSA generalnie prze�ciga OSS w kompatybilno�ci, wydajno�ci
i mo�liwo�ciach. Jednak niekt�re karty s� obs�ugiwane wy咳cznie przez komercyjn�
wersj� OSS z witryny <ulink url="http://www.opensound.com/">4Front Technologies</ulink>.
Obs�uguje ona r�wnie� kilka innych system�w poza Linuksem.
</para>

<informaltable>
<tgroup cols="8">
  <colspec colname="c1"/>
  <colspec colname="c2"/>
  <colspec colname="c3"/>
  <colspec colname="c4"/>
  <colspec colname="c5"/>
  <colspec colname="c6"/>
  <colspec colname="c7"/>
  <colspec colname="c8"/>
  <spanspec spanname="driver" namest="c2" nameend="c5"/>
  <spanspec spanname="ossfree" namest="c2" nameend="c2"/>
  <spanspec spanname="alsa" namest="c3" nameend="c3"/>
  <spanspec spanname="osspro" namest="c4" nameend="c4"/>
  <spanspec spanname="others" namest="c5" nameend="c5"/>
<thead>
  <row>
    <entry morerows="2" valign="middle">KARTA D�WI�KOWA</entry>
    <entry spanname="driver">STEROWNIK</entry>
    <entry morerows="2" valign="middle">Max cz�stotliwo倶(kHz)</entry>
    <entry morerows="2" valign="middle">Max ilo倶 kana鞄w</entry>
    <entry morerows="2" valign="middle">Max ilo倶 program�w
      <footnote id="maxopens">
        <para>ilo倶 aplikacji, kt�re s� w stanie u�ywa� urz�dzenia
         <emphasis>w tym samym czasie</emphasis>.</para>
      </footnote>
    </entry>
  </row>

  <row>
    <entry spanname="ossfree">OSS/Free</entry>
    <entry spanname="alsa">ALSA</entry>
    <entry spanname="osspro">OSS/Pro</entry>
    <entry spanname="others">inne</entry>
  </row>
</thead>

<tbody>
  <row>
    <entry>Zintegrowane karty VIA (686/A/B, 8233, 8235)</entry>
    <entry>
      <ulink url="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">via82cxxx_audio</ulink>
    </entry>
    <entry>snd-via82xx</entry>
    <entry></entry>
    <entry></entry>
    <entry>4-48 kHz lub wy咳cznie 48 kHz, w zale�no�ci od chipsetu</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Aureal Vortex 2</entry>
    <entry>brak</entry>
    <entry>brak</entry>
    <entry>OK</entry>
    <entry>
      <ulink url="http://aureal.sourceforge.net">Sterowniki do Aureala dla Linuksa </ulink>
      <ulink url="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2"> bufor zwi�kszony do 32k</ulink>
    </entry>
    <entry>48</entry>
    <entry>4.1</entry>
    <entry>5+</entry>
  </row>

  <row>
    <entry>SB Live!</entry>
    <entry>Wyj�cie analogowe-OK, SP/DIF nie dzia�a</entry>
    <entry>Oba dzia�aj�</entry>
    <entry>Oba dzia�aj�</entry>
    <entry>
      <ulink url="http://opensource.creative.com">Sterowniki OSS Creativu (obs�uga SP/DIF)</ulink>
    </entry>
    <entry>192</entry>
    <entry>4.0/5.1</entry>
    <entry>32</entry>
  </row>

  <row>
    <entry>SB 128 PCI (es1371)</entry>
    <entry>OK</entry>
    <entry>?</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry>stereo</entry>
    <entry>2</entry>
  </row>

  <row>
    <entry>SB AWE 64</entry>
    <entry>max 44kHz</entry>
    <entry>�le brzmi na 48kHz</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>GUS PnP</entry>
    <entry>brak</entry>
    <entry>OK</entry>
    <entry>OK</entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Gravis UltraSound ACE</entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Gravis UltraSound MAX</entry>
    <entry>OK</entry>
    <entry>OK (?)</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>ESS 688</entry>
    <entry>OK</entry>
    <entry>OK (?)</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Karty C-Media (CMI8338/8738)</entry>
    <entry>OK</entry>
    <entry>OK SP/DIF jest obs�ugiwane przez ALSA 0.9.x</entry>
    <entry>?</entry>
    <entry></entry>
    <entry>44</entry>
    <entry>stereo</entry>
    <entry>1</entry>
  </row>

  <row>
    <entry>Karty Yamaha (*ymf*)</entry>
    <entry>z�e (?) (mo�e <option>-ao sdl</option>)</entry>
    <entry>Dzia�a poprawnie tylko z ALSA 0.5 z w咳czon� emulacj� OSS
      <emphasis role="bold">i</emphasis> <option>-ao sdl</option> (!) (?)</entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Karty z chipami envy24 (jak Terratec EWS88MT)</entry>
    <entry>?</entry>
    <entry>?</entry>
    <entry>OK</entry>
    <entry></entry>
    <entry>?</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>PC Speaker lub DAC</entry>
    <entry>OK</entry>
    <entry>brak</entry>
    <entry></entry>
    <entry>
      <ulink url="http://www.geocities.com/stssppnn/pcsp.html">Sterowniki do PC speakera dla Linuksa (OSS)</ulink>
    </entry>
    <entry>Sterownik emuluje 44.1, mo�e wi�cej.</entry>
    <entry>mono</entry>
    <entry>1</entry>
  </row>

</tbody>
</tgroup>
</informaltable>

<para>
Pomoc przy tworzeniu tego dokumentu jest mile widziana. Powiedz jak
<application>MPlayer</application> i Twoja karta d�wi�kowa
(karty d�wi�kowe) wsp鶻pracuj� razem.
</para>
</sect3>


<sect3 id="af">
<title>Filtry audio</title>
<para>
  Stare wtyczki audio zosta�y wyparte przez now� warstw� filtr�w d�wi�kowych.
  Mog� by� one u�yte do zmiany w�a�ciwo�ci danych audio zanim d�wi�k dotrze do 
  karty. Ich uruchamianie i wy咳czanie odbywa si� przewa�nie automatycznie, 
  mo�e to by� jednak zmienione. Filtry s� w咳czane wtedy, kiedy cechy d�wi�ku
  r鷽ni� si� od tych wymaganych przez urz�dzenie audio w przeciwnym wypadku 
  procedura ta jest omijana. Opcja <option>-af filter1,filter2,...</option>
  u�ywana jest do nadpisania automatycznych ustawie� lub do zastosowania
  dodatkowych. Kolejno倶 aplikowania filtr�w uzale�niona jest od kolejno�ci 
  w ci�gu oddzielonych od siebie przecinkami warto�ci.
</para>

<para>
Przyk�ad:
<screen>mplayer -af resample,pan film.avi</screen>
uruchomi d�wi�k poprzez filtr zmieniaj�cy cz�stotliwo倶 pr�bkowania (resample filter) 
a nast�pnie poprzez filtr pan. Zauwa�, �e lista nie mo�e zawiera� �adnych spacji, 
inaczej zostanie b滑dnie zinterpretowana przez program.
</para>

<para>
Filtry cz�sto posiadaj� opcje, kt�re zmieniaj� ich zachowanie. S� one dok�adniej 
opisane w sekcji poni�ej. Je�eli pominie si� parametry, to filtr uruchomi si�
z domy�lnymi ustawieniami. Poni�ej przedstawiony jest przyk�ad jak u�ywa�
filtr�w wraz z ich opcjami:
<screen>mplayer -af resample=11025,pan=1:0.5:0.5 -channels 1 -srate 11025 media.avi</screen>
ustawi cz�stotliwo倶 wyj�ciow� filtru zmieniaj�cego pr�bkowanie (resample filter) 
na 11025Hz i zmiksuje inne kana�y do 1, u�ywaj�c filtru pan.
</para>

<para>
Og�ln� kontrol� nad warstw� filtr�w daje opcja <option>-af-adv</option>.
Zawiera ona dwie dodatkowe opcje:
</para>

<para>
<option>force</option> jest polem bitowym, kt�re okre�la jak filtry
s� stosowane i jakiej optymalizacji pr�dko�ci/dok�adno�ci u�ywaj�:
</para>

<variablelist>
<varlistentry>
<term><option>0</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w i optymalizuj wzgl�dem szybko�ci procesora.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>1</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w i optymalizuj tak, �eby osi�gn掩 najwi�ksz�
pr�dko倶.
<emphasis>Uwaga:</emphasis> Niekt�re mo�liwo�ci filtr�w audio mog� nie zadzia�a� i 
jako倶 d�wi�ku spadnie.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>2</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w i optymalizuj pod k�tem jak najwi�kszej
jako�ci.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>3</option></term>
<listitem><para>
Nie u�ywaj automatycznego stosowania filtr�w i nie optymalizuj.
<emphasis>Uwaga:</emphasis> Je�li u�ywasz tego ustawienia, mo�liwe jest
wyst�pienie b滑d�w podczas dzia�ania MPlayera i jego zako�czenie.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>4</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w (tak jak dla 0), jednak u�yj przetwarzania
zmiennoprzecinkowego kiedy to mo�liwe.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>5</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w (tak jak dla 1), jednak u�yj przetwarzania
zmiennoprzecinkowego kiedy to mo�liwe.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>6</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w (tak jak dla 2), jednak u�yj przetwarzania
zmiennoprzecinkowego kiedy to mo�liwe.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>7</option></term>
<listitem><para>
U�yj automatycznego stosowania filtr�w (tak jak dla 3), jednak u�yj przetwarzania
zmiennoprzecinkowego kiedy to mo�liwe.
</para></listitem>
</varlistentry>
</variablelist>

<para>
<option>list</option> jest aliasem dla opcji -af.
</para>

<para>
Warstwa filtr�w jest r�wnie� sterowana ni�ej podanymi, standardowymi opcjami:
</para>

<variablelist>
<varlistentry>
<term><option>-v</option></term>
<listitem><para>
Zwi�ksza poziom "gadatliwo�ci" i sprawia, �e wi�kszo倶 filtr�w drukuje dodatkowe
komunikaty.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-channels</option></term>
<listitem><para>
Ta opcja ustawia ilo倶 kana鞄w wyj�ciowych, kt�rych ma u�ywa� Twoja karta.
Ma ona r�wnie� wp�yw na ilo倶 kana鞄w, kt�re s� dekodowane z
no�nika danych. Je�li zawiera on mniej kana鞄w, filtr kana鞄w (channels filter)
zostanie automatycznie u�yty (zobacz poni�ej). Przekierowywanie b�dzie ustawione na
domy�lne.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-srate</option></term>
<listitem><para>
Opcja ta ustawia cz�stotliwo倶 pr�bkowania, kt�r� ma u�ywa� Twoja karta
(oczywi�cie karty maj� swoje ograniczenia). Je�eli poziom pr�bkowania Twojej
karty r鷽ni si� od tego stosowanego w no�niku, zostanie w咳czony filtr zmieniaj�cy
pr�bkowanie (resample filter, zobacz poni�ej), aby zniwelowa� r鷽nice.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-format</option></term>
<listitem><para>
Opcja ta ustawia format pr�bki pomi�dzy filtrem audio a kart� d�wi�kow�.
Je�eli 娠dany format pr�bki dla karty jest inny ni� format zawieraj�cy si� w no�niku,
zostanie zastosowany filtr formatu (format filter, zobacz poni�ej), aby zniwelowa� 
r鷽nice.
</para></listitem>
</varlistentry>
</variablelist>

<sect4 id="af_resample">
<title>Zmniejszenie/Zwi�kszenie cz�stotliwo�ci pr�bkowania (Up/Downsampling)</title>

<para>
MPlayer w pe�ni obs�uguje zmniejszanie/zwi�kszanie cz�stotliwo�ci (up/downsampling)
poprzez filtr zmieniaj�cy cz�stotliwo倶 pr�bkowania - <option>resample</option> filter.
Mo�e by� on u�yty, je�eli masz sta咳 cz�stotliwo倶 na karcie, albo je�eli nie jest
ona w stanie przerobi� wi�cej ni� 44.1kHz. Filtr jest automatycznie uruchamiany,
je�eli jest to konieczne, ale mo�e r�wnie� zosta� w咳czony z poziomu linii komend.
Ma trzy opcje:
</para>

<variablelist>
<varlistentry>
<term><option>srate &lt;8000-192000&gt;</option></term>
<listitem><para>
    jest to liczba ca�kowita, u�ywana do okre�lenia wyj�ciowej cz�stotliwo�ci 
    pr�bkowania w Hz. Przyjmuje warto�ci z zakresu od 8kHz do 192kHz. Je�eli
    cz�stotliwo倶 wej�ciowa i wyj�ciowa s� takie same albo je�eli ten parametr 
    jest pomini�ty, filtr jest wy咳czany. Wysoka cz�stotliwo倶 przewa�nie zwi�ksza 
    jako倶 d�wi�ku, szczeg�lnie je�eli filtr jest u�yty wraz z innymi.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>sloppy</option></term>
<listitem><para>
    jest dodatkowym parametrem binarnym, kt�ry pozwala na ma咳 r鷽nic� mi�dzy 
    cz�stotliwo�ci� wyj�ciow� a t� podan� przez <option>srate</option>. Opcja
    ta mo�e zosta� u�yta je�eli pocz�tek odtwarzania jest bardzo wolny. Jest 
    standardowo uruchomiony.
</para></listitem>
</varlistentry>


<varlistentry>
<term><option>type &lt;0-2&gt;</option></term>
<listitem><para>
    jest dodatkow� liczb� ca�kowit� z przedzia�u od <literal>0</literal> 
    do <literal>2</literal>, kt�ra wybiera metod� zmiany cz�stotliwo�ci 
    pr�bkowania. Tutaj <literal>0</literal> przedstawia interpolacj� liniow�
    (linear interpolation), <literal>1</literal> reprezentuje  metod� wielofazowego 
    przetwarzania banku filtr�w (poly-phase filter-bank processing) oraz przetwarzanie 
    ca�kowitoliczbowe, <literal>2</literal> do zmiany cz�stotliwo�ci przy u�yciu
    wielofazowego przetwarzania banku filtr�w (poly-phase filter-bank processing) 
    oraz przetwarzania zmiennoprzecinkowego. Interpolacja liniowa (linear interpolation)
    jest wyj�tkowo szybka, jednak pogarsza jako倶 d�wi�ku szczeg�lnie przy zwi�kszaniu
    cz�stotliwo�ci (upsampling). Najlepsz� jako倶 daje <literal>2</literal>,
    ale metoda ta potrzebuje najwi�kszej mocy obliczeniowej.
</para></listitem>
</varlistentry>
</variablelist>

<para>Przyk�ad:
<screen>mplayer -af resample=44100:0:0</screen>
ustawi cz�stotliwo倶 wyj�ciow� filtru zmieniaj�cego cz�stotliwo倶 pr�bkowania
(resample filter) na 44100Hz u�ywaj�c przy tym dok�adnego skalowania cz�stotliwo�ci 
wyj�ciowej oraz interpolacji liniowej (linear interpolation).
</para>
</sect4>

<sect4 id="af_channels">
<title>Zmiana liczby kana鞄w</title>
<para>
Filtr kana鞄w (<option>channels</option> filter) mo�e by� u�yty w celu dodania
lub usuni�cia kana鞄w, mo�na go u�y� tak�e do kopiowania lub przekierowywania kana鞄w.
Jest on automatycznie w咳czony, je�eli wyj�cie warstwy audio filtr�w r鷽ni si� 
od wej�ciowego lub je�eli za娠dano jego uruchomienia. Filtr wy咳cza si� sam,
je�eli nie jest u�ywany. Liczba parametr�w jest dynamiczna:
</para>

<variablelist>
<varlistentry>
<term><option>nch &lt;1-6&gt;</option></term>
<listitem><para>
  jest to liczba ca�kowita z zakresu od <literal>1</literal> do <literal>6</literal>, 
  kt�ra ustawia liczb� kana鞄w wyj�ciowych. Ta opcja jest wymagana,
  w przypadku je�eli nie zostanie podana, program wywo�a b咳d uruchamiania
  (runtime error).
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>nr &lt;1-6&gt;</option></term>
<listitem><para>
  jest to liczba ca�kowita z zakresu od <literal>1</literal> do <literal>6</literal>, 
  kt�ra u�ywana jest do podania liczby dr�g rutowania. Ten parametr jest opcjonalny. 
  Je�eli jest pomini�ty, stosowane jest domy�lne rutowanie.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>od1:do1:od2:do2:od3:do3...</option></term>
<listitem><para>
  to pary liczb pomi�dzy <literal>0</literal> a <literal>5</literal>, kt�re
  okre�laj� gdzie poszczeg�lny kana� ma by� przekierowywany.
</para></listitem>
</varlistentry>
</variablelist>

<para>
  Je�eli tylko opcja <option>nch</option> jest podana, u�yte jest domy�lne przekierowywanie,
  dzia�a ono nast�puj�co: Je�eli ilo倶 kana鞄w wyj�ciowych jest wi�ksza ni� 
  wej�ciowych, tworzone s� puste kana�y (poza miksowaniem z mono do stereo, 
  wtedy kana� mono jest powtarzany w obu kana�ach wyj�ciowych). Je�eli ilo倶 
  kana鞄w wyj�ciowych jest mniejsza ni� wej�ciowych, nadmiarowe kana�y b�d� usuwane.
</para>

<para>
Przyk�ad 1:
<screen>mplayer -af channels=4:4:0:1:1:0:2:2:3:3 media.avi</screen>
zmieni ilo倶 kana鞄w na 4 i ustawia 4 drogi przekierowywania, kt�re zamieniaj�
kana� 1 z 0, a 2 i 3 pozostawiaj� bez zmian. Zauwa�, �e je�eli odtwarzany
by� no�nik zawieraj�ce 2 kana�y, kana�y 2 i 3 b�d� puste ale
0 i 1 ci�gle zamienione.
</para>


<para>
Przyk�ad 2:
<screen>mplayer -af channels=6:4:0:0:0:1:0:2:0:3 media.avi</screen>
zmieni ilo倶 kana鞄w na 6 i ustawi 4 drogi przekierowywania, kt�re skopiuj�
kana� 0 do 0 i 3. Kana�y 4 i 5 b�d� puste.
</para>
</sect4>

<sect4 id="af_format">
<title>Konwerter formatu pr�bek (sample format converter)</title>
<para>
Filtr formatu (<option>format</option> filter)  przekszta�ca r鷽ne formaty
pr�bek w inne. Jest automatycznie uruchamiany, kiedy jest potrzebny przez 
kart� lub inny filtr d�wi�kowy.
</para>

<variablelist>
<varlistentry>
<term><option>bps &lt;numer&gt;</option></term>
<listitem><para>
    mo�e mie� warto倶 <literal>1</literal>, <literal>2</literal> lub 
    <literal>4</literal>, okre�la ilo倶 bajt�w przypadaj�c� na pr�bk�. Parametr 
    ten jest wymagany, je�eli nie zostanie podany, program wywo�a b咳d uruchamiania
    (runtime error).
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>f &lt;format&gt;</option></term>
<listitem><para>
    jest ci�giem znak�w, okre�laj�cych pr�bk�. Ci�g jest kombinacj�:
    <option>alaw</option>, <option>mulaw</option> lub
    <option>imaadpcm</option>, <option>float</option> lub <option>int</option>,
    <option>unsigned</option> lub <option>signed</option>, <option>le</option> lub
    <option>be</option> (little lub big endian). Opcja ta jest wymagana, je�eli
    nie zostanie podana, program wywo�a b咳d podczas uruchamiania (runtime error).
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad:
<screen>mplayer -af format=4:float media.avi</screen>
ustawi format wyj�ciowy na 4 bajty danych zmiennoprzecinkowych przypadaj�cych na pr�bk�.
</para>
</sect4>

<sect4 id="af_delay">
<title>Op鷦nianie (delay)</title>
<para>
Filtr op鷦niaj�cy (<option>delay</option> filter) op鷦nia d�wi�k zmierzaj�cy do
g�o�nik�w, tak �eby strumienie d�wi�kowe z r鷽nych kana鞄w dotar�y do nich 
jednocze�nie. Jest to u�yteczne, je�eli masz wi�cej ni� 2 g�o�niki. Filtr 
ma kilka opcji:
</para>

<variablelist>
<varlistentry>
<term><option>d1:d2:d3...</option></term>
<listitem><para>
    s� liczbami rzeczywitymi, kt�re przedstawiaj� op鷦nienie w ms,
    kt�re powinno by� zastosowane do ka�dego kana�u. Minimalna warto倶 to 0ms a 
    maksymalna to 1000ms.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Aby obliczy� op鷦nienie dla poszczeg�lnych kana鞄w, wykonaj co nast�puje:
</para>

<orderedlist>
<listitem><para>
    Oblicz odleg�o倶 od g�o�nik�w do pozycji s�uchacza (w metrach), to da Ci
    warto�ci od s1 do s5 (dla systemu 5.1). Nie ma sensu bra� pod uwag� 
    subwoofera (i tak nie us�yszysz r鷽nicy).
</para></listitem>
<listitem><para>
Odejmij odleg�o倶 od s1 do s5 od odleg�o�ci maksymalnej tzn.
    s[i] = max(s) - s[i]; i = 1...5
</para></listitem>
<listitem><para>
Oblicz op鷦nienia w nast�puj�cy spos�b
    d[i] = 1000*s[i]/342; i = 1...5
</para></listitem>
</orderedlist>

<para>
Przyk�ad:
<screen>mplayer -af delay=10.5:10.5:0:0:7:0 media.avi</screen>
op鷦ni lewy i prawy przedni g�o�nik o 10.5ms, dwa tylnie i subwoofer o 0ms a
centralny o 7ms.
</para>

</sect4>

<sect4 id="af_volume">
<title>Programowa regulacja g�o�no�ci (software volume control)</title>

<para>Programowa regulacja g�o�no�ci (software volume control) jest obs�ugiwana
poprzez filtr g�o�no�ci (<option>volume</option> filter). U�ywaj go ostro�nie,
gdy� mo�e obni�y� stosunek sygna�u do szumu. W wi�kszo�ci wypadk�w
najlepszym rozwi�zaniem jest ustawienie miksera PCM na maksymaln� warto倶, wy咳czy to 
filtr, a Ty b�dziesz m�g� regulowa� g�o�no倶 poprzez g�o�niki. Je�eli Twoja karta
ma cyfrowy mikser PCM zamiast analogowego i zauwa�ysz przek�amania, u�yj miksera 
MASTER. Je�eli do komputera pod咳czony jest zewn�trzny wzmacniacz 
(tak to zazwyczaj wygl�da), poziom ha�asu mo�e zosta� zredukowany poprzez 
dostrojenie g鞄wnego poziomu g�o�no�ci (master level) i pokr�t�a g�o�no�ci, 
dop�ki syczenie w tle nie ustanie. Filtr ma dwie opcje:
</para>

<variablelist>
<varlistentry>
<term><option>v &lt;-200 - +60&gt;</option></term>
<listitem><para>
    jest liczb� rzeczywist� pomi�dzy <literal>-200</literal> a
    <literal>+60</literal>, kt�ra przedstawia poziom g�o�no�ci w dB. Domy�lny
     poziom to 0dB.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>c</option></term>
<listitem><para>
    jest binarn� warto�ci� kt�ra w咳cza lub wy咳cza mi�kkie obcinanie (soft-clipping). 
    Mi�kkie obcinanie (soft-clipping)  mo�e sprawi�, �e d�wi�k b�dzie �agodniejszy,
    je�eli wysokie poziomy d�wi�ku s� u�yte. Uaktywnij t� opcj�, je�eli moc
    g�o�nik�w jest zbyt niska. Zwr黽 uwag�, �e ta metoda tworzy przek�amania i
    powinna zosta� u�yta w ostateczno�ci.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad:
<screen>mplayer -af volume=10.1:0 media.avi</screen>
wzmocni d�wi�k o 10.1dB i zastosuje metod� twardego obcinania (hard-clip), je�eli 
poziom d�wi�ku jest za wysoki.
</para>

<para>
Ten filtr ma drug� w�a�ciwo倶: Mierzy og�lny, maksymalny poziom d�wi�ku i wypisuje go
po zako�czeniu MPlayera. Oszacowana g�o�no倶 mo�e by� u�yta do ustawienia poziomu 
d�wi�ku w MEncoderze tak, �eby maksymalny zasi�g dynamiczny by� mo�liwy do 
osi�gni�cia.
</para>
</sect4>

<sect4 id="af_equalizer">
<title>Korektor (equalizer)</title>
<para>
Filtr korektora (<option>equalizer</option> filter) to 10 oktawowy,
graficzny korektor pasm, zaimplementowany
przy pomocy filtr�w przej倶 10 pasm IIR (10 IIR band pass filters). Oznacza to,
�e dzia�a bez wzgl�du na format odtwarzanego d�wi�ku. �rodkowe
cz�stotliwo�ci dla 10 pasm to:
</para>

<informaltable>
<tgroup cols="2">
<thead>
  <row>
    <entry>Numer pasma</entry><entry>Cz�stotliwo倶 �rodkowa</entry>
  </row>
</thead>
<tbody>
  <row><entry>0</entry><entry>31.25 Hz</entry></row>
  <row><entry>1</entry><entry>62.50 Hz</entry></row>
  <row><entry>2</entry><entry>125.0 Hz</entry></row>
  <row><entry>3</entry><entry>250.0 Hz</entry></row>
  <row><entry>4</entry><entry>500.0 Hz</entry></row>
  <row><entry>5</entry><entry>1.000 kHz</entry></row>
  <row><entry>6</entry><entry>2.000 kHz</entry></row>
  <row><entry>7</entry><entry>4.000 kHz</entry></row>
  <row><entry>8</entry><entry>8.000 kHz</entry></row>
  <row><entry>9</entry><entry>16.00 kHz</entry></row>
</tbody>
</tgroup>
</informaltable>

<para>
Je�eli cz�stotliwo倶 pr�bkowania odtwarzanego d�wi�ku jest ni�sza ni� �rodkowa
cz�stotliwo倶 dla odpowiedniego pasma, to jest ono wy咳czane. Znanym b滑dem
jest to, �e w�a�ciwo�ci dla najwy�szego pasma nie s� ca�kowicie symetryczne,
je�eli cz�stotliwo倶 pr�bki jest zbli�ona do cz�stotliwo�ci �rodkowej danego pasma.
Mo�na obej倶 ten problem zwi�kszaj�c jej cz�stotliwo倶 (up-sampling), zanim ta
dotrze do filtru korektora (equalizer filter).
</para>

<para>
Filtr ma 10 parametr�w:
</para>

<variablelist>
<varlistentry>
<term><option>g1:g2:g3...g10</option></term>
<listitem><para>
s� liczbami rzeczywistymi z przedzia�u od <literal>-12</literal> do
<literal>+12</literal>, okre�laj�cymi przyrost dB dla ka�dego pasma cz�stotliwo�ci.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad:
<screen>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi</screen>
wzmocni d�wi�k w wy�szych i ni�szych zakresach cz�stotliwo�ci, wyciszaj�c go 
prawie ca�kowicie oko�o 1kHz.
</para>
</sect4>

<sect4 id="af_panning">
<title>Filtr pan (panning filter)</title>
<para>
U�yj filtru pan (<option>pan</option> filter), �eby dowolnie miksowa� kana�y. Najpro�ciej 
t�umacz�c jest to po咳czenie programowej regulacji g�o�no�ci� (software volume control) i 
filtru kana鞄w (channels filter). Istniej� jego 2 podstawowe zastosowania:
</para>

<orderedlist>
<listitem><para>
Miksowanie wielu kana鞄w w mniejsz� ilo倶, stereo do mono na przyk�ad.
</para></listitem>
<listitem><para>
Zmienianie &quot;szeroko�ci&quot; centralnego g�o�nika w systemie przestrzennym.
</para></listitem>
</orderedlist>

<para>
Filtr jest trudny w u�yciu i b�dzie wymaga� zastosowania �mudnej metody pr�b i b滑d�w,
zanim zostanie osi�gni�ty oczekiwany rezultat. Liczba parametr�w filtru zale�y od
ilo�ci kana鞄w:
</para>

<variablelist>
<varlistentry>
<term><option>nch &lt;1-6&gt;</option></term>
<listitem><para>
jest liczb� ca�kowit� z przedzia�u od <literal>1</literal> do <literal>6</literal> i 
jest u�ywana w celu okre�lenia liczby kana鞄w wyj�ciowych. Opcja ta jest wymagana, 
je�eli nie zostanie podana, program wywo�a b咳d uruchamiania (runtime error).
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>l00:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...</option></term>
<listitem><para>
s� liczbami rzeczywistymi z przedzia�u od <literal>0</literal> do
<literal>1</literal>. <option>l[i][j]</option> ustala ile procent kana�u wej�ciowego j 
ma by� zmiksowanych do kana�u wyj�ciowego i.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad 1:
<screen>mplayer -af pan=1:0.5:0.5 -channels 1 media.avi</screen>
zmiksuje kana�y ze stereo do mono.
</para>

<para>
Przyk�ad 2:
<screen>mplayer -af pan=3:1:0:1:0.5:0.5 -channels 3 media.avi</screen>
da 3 kana� wyj�ciowy, zostawiaj�c 0 i 1 nietkni�tymi i miksuj�c kana�y 0 i 1
do 2 kana�u wyj�ciowego (kt�ry mo�e by� na przyk�ad wys�any do subwoofera).
</para>
</sect4>

<sect4 id="af_sub">
<title>Subwoofer</title>
<para>
Filtr subwoofera (<option>sub</option> filter) dodaje kana� subwoofera do strumienia
audio. Dane audio u�yte do stworzenia tego kana�u s� �redni� d�wi�ku w 0 i 1 kanale. D�wi�k 
wynikowy zostanie poddany dzia�aniu 4-rz�dowego, dolnoprzepustowego filtru Butterwortha 
(4th order Butterworth filter) z domy�ln� cz�stotliwo�ci� graniczn� na poziomie 60Hz i 
dodany do oddzielnego kana�u w strumieniu audio.
Uwaga: Wy咳cz ten filtr, je�eli odtwarzasz DVD z d�wi�kiem w systemie Dolby Digital 5.1, 
w przeciwnym wypadku, jego dzia�anie zak鞄ci d�wi�k subwoofera. Filtr ma 2 parametry:
</para>

<variablelist>
<varlistentry>
<term><option>fc &lt;20-300&gt;</option></term>
<listitem><para>
    jest opcjonaln� liczb� rzeczywist�, u�ywan� do okre�lenia warto�ci
    cz�stotliwo�ci granicznej w Hz. Prawid�owy zakres wynosi od 20Hz do 300Hz. Dla 
    uzyskania najlepszego rezultatu, spr�buj ustawi� j� na jak najni�sz�. Wzbogaci to
    do�wiadczenia p�yn�ce z u�ywania d�wi�ku stereo i w systemie przestrzennym. Domy�ln� 
    warto�ci� jest 60Hz.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>ch &lt;0-5&gt;</option></term>
<listitem><para>
    jest opcjonaln� liczb� ca�kowit� pomi�dzy <literal>0</literal> a 
    <literal>5</literal>, kt�ra okre�la numer kana�u, do kt�rego ma zosta� wys�any
    d�wi�k subwoofera. Domy�lnym jest <literal>5</literal>. Zauwa�, �e liczb� kana鞄w
    zwi�kszy si� do <replaceable>ch</replaceable>, je�eli zajdzie taka potrzeba.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad:
<screen>mplayer -af sub=100:4 -channels 5 media.avi</screen>
doda kana� subwoofera z cz�stotliwo�ci� graniczn� r�wn� 100Hz do 4 kana�u wyj�ciowego.
</para>
</sect4>

<sect4 id="af_surround">
<title>Dekoder d�wi�ku przestrzennego (Surround-sound decoder)</title>
<para>
Macierzowo zakodowany d�wi�k przestrzenny, mo�e by� zdekodowany filtrem przestrzennym
(<option>surround</option> filter). Dolby Surround jest przyk�adem
formatu zakodowanego macierzowo. Wiele plik�w zawieraj�cych 2 kana�y audio,
faktycznie zawiera d�wi�k przestrzenny zakodowany w tym systemie. Aby u�y� 
tego filtru potrzebujesz karty z obs�ug� przynajmniej 4 kana鞄w. Filtr 
posiada jedn� opcj�:
</para>

<variablelist>
<varlistentry>
<term><option>d &lt;0-1000&gt;</option></term>
<listitem><para>
jest opcjonaln� liczb� rzeczywist� pomi�dzy <literal>0</literal> a
<literal>1000</literal>, u�ywan� do ustawienia op鷦nienia w ms dla tylnych g�o�nik�w.
Op鷦nienie powinno by� ustawione w nast�puj�cy spos�b: je�li d1 to odleg�o倶 od 
pozycji s�uchacza do przednich g�o�nik�w a d2 to odleg�o倶 od tylnych g�o�nik�w,
to op鷦nienie d powinno by� ustawione na 15ms, je�eli d1 &lt;= d2 i 15 + 5*(d1-d2)
je�eli d1 &gt; d2. Domy�lna warto倶 dla d to 20ms.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad:
<screen>mplayer -af surround=15 -channels 4 media.avi</screen>
doda d�wi�k przestrzenny dekoduj�c z 15ms op鷦nieniem d�wi�k dla tylnych g�o�nik�w.
</para>
</sect4>

<sect4 id="af_export">
<title>Audio Exporter</title>
<para>
Ten filtr audio eksportuje nadchodz�cy sygna� do innych proces�w,
u�ywaj�c mapowania pami�ci (<literal>mmap()</literal>). 
Zmapowane obszary zawieraj� nag鞄wek:

<programlisting>
int nch                      /*ilo倶 kana鞄w*/
int size		     /*rozmiar bufora*/
unsigned long long counter   /*U�ywany do zachowania synchronizacji, 
                               aktualizowany za ka�dym razem kiedy nowe dane
			       s� eksportowane.*/
</programlisting>
Reszta to 16-bitowe dane (bez przeplotu).
</para>

<variablelist>
<varlistentry>
<term><option>mmapped_file</option></term>
<listitem><para>
Plik, do kt�rego chcesz eksportowa�. Domy�lnie jest to  
<filename>~/.mplayer/mplayer-af_export</filename>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>nsamples</option></term>
<listitem><para>
Ilo倶 pr�bek przypadaj�cych na kana�. Domy�lnie jest to <literal>512</literal>.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Przyk�ad:
<screen>mplayer -af export=/tmp/mplayer-af_export:1024 media.avi</screen>
wyeksportuje 1024 pr�bek na kana� do <filename>/tmp/mplayer-af_export</filename>.
</para>
</sect4>
</sect3>

<sect3 id="audio-plugins">
<title>Wtyczki Audio (odradzane)</title>
<note><para><emphasis role="bold">Wtyczki audio zosta�y wyparte przez filtry audio i 
wkr�tce zostan� usuni�te.</emphasis></para></note>

<para>
<application>MPlayer</application> ma obs�ug� wtyczek audio. Mog� one by�
u�yte do zmiany w�a�ciwo�ci danych audio, zanim d�wi�k dotrze do karty. W咳cza 
je si� poprzez opcj� <option>-aop</option>, kt�ra przyjmuje argumenty w postaci 
<option>list=wtyczka1,wtyczka2,...</option>. Argument <option>list</option> 
jest wymagany i okre�la, kt�re wtyczki powinny zosta� u�yte i w jakiej kolejno�ci. 
Przyk�ad:

<screen>mplayer media.avi -aop list=resample,format</screen>

przepu�ci d�wi�k przez wtyczk� zmieniaj�c� cz�stotliwo倶 pr�bkowania 
(resampling plugin) a nast�pnie wtyczk� formatu (format plugin).
</para>

<para>
Wtyczki r�wnie� posiadaj� parametry, kt�re zmieniaj� ich zachowanie. Opisane s� 
one dok�adniej w sekcji poni�ej. Wtyczka uruchomi si� z domy�lnymi warto�ciami, 
je�eli pominiemy jej opcje.  Poni�ej podany jest przyk�ad u�ycia wtyczek i 
ich specyficznych ustawie�:

<screen>mplayer media.avi -aop list=resample,format:fout=44100:format=0x8</screen>

ustawi cz�stotliwo倶 wyj�ciow� dla wtyczki zmieniaj�cej cz�stotliwo倶 pr�bkowania 
(resample plugin) na 44100 Hz i format wyj�ciowy wtyczki formatu (format plugin) 
na AFMT_U8.
</para>

<para>
Obecnie wtyczki audio nie mog� zosta� u�yte w <application>MEncoderze</application>.
</para>


<sect4 id="updn-sampling">
<title>Zwi�kszanie/Zmniejszanie cz�stotliwo�ci pr�bkowania (up/downsampling)</title>

<para>
<application>MPlayer</application> w pe�ni obs�uguje zmniejszanie/zwi�kszanie
cz�stotliwo�ci pr�bkowania (up/downsampling) d�wi�ku. Wtyczka ta mo�e by�
u�yta, je�eli masz kart� ze sta咳 cz�stotliwo�ci� lub posiadasz kart�, kt�ra 
nie jest w stanie przerobi� wi�cej ni� 44.1 kHz. Ograniczenia Twojego sprz�tu
nie s� automatycznie wykrywane, wi�c musisz wyra�nie poda� cz�stotliwo倶.
Wtyczka ma jeden prze咳cznik: <option>fout</option>, kt�ry u�ywany jest do
ustawiania 娠danej cz�stotliwo�ci wyj�ciowej. Domy�ln� warto�ci� jest
48 kHz i podawana jest w Hz.
</para>


<para>
Spos�b u�ycia:

<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=resample:fout=<replaceable>freq</replaceable></screen>

gdzie <literal><replaceable>freq</replaceable></literal> jest cz�stotliwo�ci�
w Hz, jak <literal>44100</literal>.
</para>

<note>
<para>
Cz�stotliwo倶 wyj�ciow� nie powinna by� wy�sza ni� warto倶 domy�lna.
Spowoduje to odtwarzanie strumieni audio i video w zwolnionym tempie oraz
zak鞄cenia d�wi�ku.
</para>
</note>
</sect4>


<sect4 id="surround-decode">
<title>Dekodowanie d�wi�ku przestrzennego</title>

<para>
<application>MPlayer</application> posiada wtyczk�, kt�ra umo�liwia dekodowanie
macierzowo zakodowanego d�wi�ku przestrzennego. Dolby Surround jest przyk�adem
takiego formatu.  Wiele plik�w zawieraj�cych 2 kana�y audio faktycznie zawiera
d�wi�k przestrzenny zakodowany macierzowo. Aby skorzysta� z tej w�a�ciwo�ci potrzebujesz karty
z obs�ug� przynajmniej 4 kana鞄w.
</para>

<para>
Spos�b u�ycia:
<screen>mplayer <replaceable>media.avi</replaceable> -aop list=surround</screen>
</para>
</sect4>


<sect4 id="sample-format-conv">
<title>Konwerter formatu pr�bek (sample format converter)</title>

<para>
Je�eli Tw�j sterownik do karty d�wi�kowej nie obs�uguje 16-bitowego typu danych ze znakiem,
ta wtyczka mo�e by� u�yta do jego zmiany na format zrozumia�y dla 
karty. Posiada jeden parametr - <option>format</option>, kt�ry mo�e by� ustawiony
na jedn� z warto�ci umieszczonych w <filename>libao2/afmt.h</filename>. Wtyczka 
ta jest raczej rzadko potrzebna i jest przeznaczona dla zaawansowanych u�ytkownik�w.
Mniej na uwadze, �e zmienia ona tylko format pr�bki a nie jej cz�stotliwo倶 czy 
ilo倶 kana鞄w.
</para>

<para>
Spos�b u�ycia:

<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=format:format=<replaceable>outfmt</replaceable></screen>

gdzie <literal><replaceable>outfmt</replaceable></literal> to wymagany format
pr�bki.
</para>
</sect4>

<sect4 id="audio-delay">
<title>Op鷦nianie</title>
<para>
Wtyczka op鷦nia d�wi�k i jest przyk�adem tego, jak tworzy� nowe wtyczki. Nie ma
dla niej �adnego sensownego zastosowania z punktu widzenia u�ytkownika i wspomnia�em 
tylko o niej ze wzgl�du na kompletno倶 tej dokumentacji. Nie u�ywaj tej wtyczki,
chyba �e jeste� developerem.
</para>
</sect4>

<sect4 id="sw-volume">
<title>Programowa regulacja g�o�no�ci� (software volume control)</title>

<para>
Wtyczka jest programowym odpowiednikiem regulacji g�o�no�ci� i mo�e
by� u�ywana na maszynach z uszkodzonym urz�dzeniem miksuj�cym. Mo�e by� r�wnie�
przydatna, je�eli kto� chce zmieni� poziom wyj�ciowy g�o�no�ci w 
<application>MPlayerze</application> bez zmiany ustawie� PCM w mikserze. 
Ma jeden parametr - <option>volume</option>, kt�ry s�u�y do ustawienia pocz�tkowej
g�o�no�ci. Mo�e przyjmowa� warto�ci pomi�dzy 0 a 255. Warto�ci� domy�lna jest 101,
co odpowiada wzmocnieniu r�wnemu 0dB. U�ywaj tej wtyczki z ostro�no�ci�, gdy� 
mo�esz obni�y� poziom sygna�u do szumu. W wi�kszo�ci wypadk�w najlepszym 
rozwi�zaniem jest ustawienie miksera PCM na maksymaln� warto倶 i, zamiast wtyczk�, 
regulowa� g�o�no倶 przy pomocy g�o�nik�w. Je�eli do komputera pod咳czony jest zewn�trzny wzmacniacz 
(a zazwyczaj jest), poziom ha�asu mo�e zosta� zredukowany poprzez
dostrojenie g鞄wnego poziomu g�o�no�ci (master level) i pokr�t�a g�o�no�ci, 
dop�ki syczenie w tle nie ustanie.
</para>

<para>
Spos�b u�ycia:
<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=volume:volume=<replaceable>0-255</replaceable></screen>
</para>

<para>
Wtyczka ma r�wnie� kompresor lub zdolno倶 do mi�kkiego obcinania (soft-clipping).
Kompresja mo�e by� u�yta, je�eli dynamika d�wi�ku jest bardzo wysoki lub
je�eli moc g�o�nik�w jest zbyt niska. B�d� ostro�ny, poniewa� ta
funkcja tworzy zak鞄cenia d�wi�ku i powinna by� u�yta w ostateczno�ci.
</para>

<para>
Spos�b u�ycia:
<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=volume:softclip</screen>
</para>
</sect4>

<sect4 id="extrastereo">
<title>Extrastereo</title>

<para>
Wtyczka (liniowo) zwi�ksza r鷽nic� pomi�dzy lewym a prawym kana�em
(jak wtyczka extrastereo w <application>XMMS</application>), co dodaje 
efekt "na �ywo" do odtwarzanego d�wi�ku.
</para>

<para>
Spos�b u�ycia:
<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=extrastereo
mplayer <replaceable>media.avi</replaceable> -aop list=extrastereo:mul=3.45<!--
--></screen>

Wsp鶻czynnikiem (<option>mul</option>) jest liczba rzeczywista,
kt�rej warto倶 domy�lna to 2.5. Je�eli ustawisz go na <literal>0.0</literal>, otrzymasz
d�wi�k mono (�rednia obu kana鞄w). Je�li na <literal>1.0</literal>, nic si� nie 
zmieni, a je�li na <literal>-1.0</literal>, lewy i prawy kana� zostan� zamienione.
</para>
</sect4>


<sect4 id="volnorm">
<title>Normalizator g�o�no�ci (volume normalizer)</title>

<para>
Wtyczka ustawia maksymalny poziom d�wi�ku, bez wywo�ywania zak鞄ce�.
</para>

<para>
Spos�b u�ycia:
<screen>mplayer <replaceable>media.avi</replaceable> -aop list=volnorm</screen>
</para>
</sect4>
</sect3>
</sect2>