mpv/DOCS/xml/pl/audio.xml

<?xml version="1.0" encoding="iso-8859-2"?>
<!-- synced with 1.8  -->
<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>
</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>