windows support: remove _UWIN define
[mplayer.git] / DOCS / xml / pl / ports.xml
blob48709fd65215fc7564620b8278e152c23ed58dd5
1 <?xml version="1.0" encoding="utf-8"?>
2 <!-- synced with r18923 -->
3 <!-- Opiekun: brak (spadek po Paszczim); chwilowo boski -->
4 <chapter id="ports" xreflabel="Ports">
5 <title>Porty</title>
7 <sect1 id="linux">
8 <title>Linux</title>
9 <para>
10 Główną platformą rozwojową jest Linux x86, chociaż
11 <application>MPlayer</application> pracuje również na wielu innych portach
12 tego systemu. Pakiety binarne są dostępne z kilku źródeł, jednakże
13 <emphasis role="bold">żaden z nich nie jest przez nas obsługiwany</emphasis>.
14 Zgłaszaj problemy do ich opiekunów, a nie do nas.
15 </para>
17 <sect2 id="debian">
18 <title>Pakiety Debiana</title>
19 <para>
20 Aby zbudować pakiet dla Debiana, wywołaj poniższe polecenie w katalogu ze źródłami
21 <application>MPlayera</application>:
23 <screen>fakeroot debian/rules binary</screen>
25 Jeśli chcesz przekazać własne opcje do skryptu configure, możesz ustawić zmienną
26 środowiskową <envar>DEB_BUILD_OPTIONS</envar>. Na przykład, jeśli chcesz
27 obsługi menu i GUI, wyglądało by to tak:
29 <screen>DEB_BUILD_OPTIONS="--enable-gui --enable-menu" fakeroot debian/rules binary</screen>
31 Możesz przekazać również niektóre zmienne do Makefile. Na przykład, jeśli chcesz
32 kompilować przy pomocy gcc 3.4, nawet jeśli nie jest to domyślny kompilator:
34 <screen>CC=gcc-3.4 DEB_BUILD_OPTIONS="--enable-gui" fakeroot debian/rules binary</screen>
36 Aby wyczyściś katalog ze źródłami wykonaj poniższa komendę:
38 <screen>fakeroot debian/rules clean</screen>
40 Jako superużytkownik możesz zainstalować pakiet <filename>.deb</filename> tak, jak zwykle:
42 <screen>dpkg -i ../mplayer_<replaceable>wersja</replaceable>.deb</screen>
43 </para>
45 <para>
46 Christian Marillat buduje dla Debiana nieoficjalne paczki
47 <application>MPlayera</application>, <application>MEncodera</application>
48 i naszych czcionek bitmapowych już od jakiegoś czasu, możesz je pobrać (apt-get)
49 z <ulink url="http://www.debian-multimedia.org/">jego strony domowej</ulink>.
50 </para>
51 </sect2>
53 <sect2 id="rpm">
54 <title>Pakiety RPM</title>
55 <para>
56 Dominik Mierzejewski opiekuje się oficjalnymi pakietami RPM
57 <application>MPlayera</application> dla Fedora Core.
58 Są one dostępne w
59 <ulink url="http://rpm.livna.org/">repozytorium Livna</ulink>.
60 </para>
62 <para>
63 RPMy dla Mandrake/Mandriva są dostępne na <ulink url="http://plf.zarb.org/">P.L.F.</ulink>.
64 SuSE zawierał okrojoną wersję <application>MPlayera</application> w dystrybucji.
65 Usunęli ją w swoich najnowszych wydaniach. W pełni funkcjonalne
66 pakiety możesz pobrać z
67 <ulink url="http://packman.links2linux.de/?action=128">links2linux.de</ulink>.
68 </para>
69 </sect2>
71 <sect2 id="arm">
72 <title>ARM</title>
73 <para>
74 <application>MPlayer</application> działa również na PDA z procesorami ARM
75 działających pod kontrolą Linuksa, np. Sharp Zaurus, Compaq iPAQ.
76 Najprostszym sposobem, żeby uzyskać <application>MPlayera</application>,
77 jest pobranie go z odpowiedniego źródła pakietów (stable, testing, unstable)
78 z witryny <ulink url="http://www.openzaurus.org">OpenZaurus</ulink>. Jeżeli chcesz
79 go skompilować samodzielnie, powinieneś przyjrzeć się katalogom
80 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/mplayer?nav=index.html|src/.|src/packages">mplayera</ulink>
81 i biblioteki
82 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/libavcodec?nav=index.html|src/.|src/packages">libavcodec</ulink>
83 w głównym katalogu źródłowym OpenZaurusa. Zawierają one najświeższe łatki
84 i pliki Makefile, służące do samodzielnej kompilacji
85 <application>MPlayera</application> z <systemitem class="library">libavcodec</systemitem>.
86 Jeżeli potrzebujesz interfejsu GUI, możesz użyć xmms-embedded.
87 </para>
88 </sect2>
89 </sect1>
91 <sect1 id="bsd">
92 <title>*BSD</title>
93 <para>
94 <application>MPlayer</application> działa na FreeBSD, OpenBSD, NetBSD,
95 BSD/OS i Darwinie. Dostępne są wersje portów/pkgsrc/fink/itp., które
96 prawdopodobnie są łatwiejsze w instalacji, niż kompilacja ze źródeł.
97 </para>
99 <para>
100 Do zbudowania <application>MPlayera</application> będziesz potrzebował
101 GNU make (gmake - rdzenne make BSD nie zadziała) i najnowszej wersji binutils.
102 </para>
104 <para>
105 Jeżeli <application>MPlayer</application> nie może znaleźć
106 <filename>/dev/cdrom</filename> lub <filename>/dev/dvd</filename>,
107 stwórz odpowiednie dowiązanie symboliczne:
108 <screen>ln -s /dev/<replaceable>twoje_urządzenie_cdrom</replaceable> /dev/cdrom</screen>
109 </para>
111 <para>
112 Aby używać bibliotek Win32 z <application>MPlayerem</application>, będziesz
113 potrzebował przekompilować jądro z opcją &quot;<envar>USER_LDT</envar>&quot;
114 (chyba, że używasz FreeBSD-CURRENT, tam jest domyślnie włączona).
115 </para>
117 <sect2 id="freebsd">
118 <title>FreeBSD</title>
119 <para>
120 Jeżeli Twój procesor ma rozszerzenie SSE, przekompiluj jądro z opcją
121 &quot;<envar>CPU_ENABLE_SSE</envar>&quot; (wymagany FreeBSD-STABLE lub łaty na jądro).
122 </para>
123 </sect2>
125 <sect2 id="openbsd">
126 <title>OpenBSD</title>
127 <para>Ze względu na ograniczenia w różnych wersjach gas (GNU assemblera - przyp. tłumacza)
128 (dotyczące relokacji i MMX), będziesz musiał przeprowadzić kompilację w dwóch krokach:
129 Po pierwsze, upewnij się, że wersja nierdzenna występuje w zmiennej <envar>$PATH</envar>
130 i wykonaj <command>gmake -k</command>, a następnie upewnij się, że używana jest wersja rdzenna
131 i wykonaj <command>gmake</command>.
132 </para>
133 <para>
134 Powyższa metoda nie jest już potrzebna w OpenBSD 3.4.
135 </para>
136 </sect2>
138 <sect2 id="darwin">
139 <title>Darwin</title>
140 <para>
141 Zobacz rozdział <link linkend="macos">Mac OS</link>.
142 </para>
143 </sect2>
144 </sect1>
146 <sect1 id="unix">
147 <title>Komercyjny Unix</title>
149 <para>
150 <application>MPlayer</application> został przeportowany na wiele komercyjnych
151 wariantów Uniksa. Jako, że środowiska programistyczne przeważnie różnią się od tych
152 znajdowanych w wolnych Uniksach, być może będziesz musiał wprowadzić ręczne
153 poprawki, aby program skompilował się poprawnie.
154 </para>
155 <sect2 id="solaris">
156 <title>Solaris</title>
158 <para>
159 <application>MPlayer</application> powinien działać na Solarisie 2.6 lub nowszym.
160 Możesz skorzystać ze sterownika dźwięku SUN'a podająć opcję <option>-ao sun</option>.
161 </para>
163 <para>
164 Na <emphasis role="bold">UltraSPARCach</emphasis>,
165 <application>MPlayer</application> korzysta z rozszerzenia
166 <emphasis role="bold">VIS</emphasis> (odpowiednik MMX), obecnie tylko w
167 <emphasis><systemitem class="library">libmpeg2</systemitem></emphasis>,
168 <emphasis><systemitem class="library">libavo</systemitem></emphasis> i
169 <emphasis><systemitem class="library">libavcodec</systemitem></emphasis>,
170 ale nie w <systemitem class="library">mp3lib</systemitem>. Możesz oglądać plik VOB na
171 procesorze z taktowaniem 400MHz. Będziesz potrzebował do tego biblioteki
172 <ulink url="http://www.sun.com/sparc/vis/mediaLib.html">
173 <systemitem class="library">mLib</systemitem></ulink>.
174 </para>
176 <para><emphasis role="bold">Caveat:</emphasis></para>
177 <itemizedlist>
178 <listitem><para><emphasis role="bold">mediaLib</emphasis> jest
179 <emphasis role="bold">aktualnie wyłączone</emphasis> w domyślnej
180 konfiguracji <application>MPlayera</application>, z powodu błędów.
181 Użytkownicy SPARC-ów, którzy budują MPlayera z obsługą mediaLib
182 informowali o delikatnym, zielonymi miganiu wideo kodowane i dekodowanego
183 przez libavcodec. Możesz włączyć mediaLib, jeżeli chcesz używając:
184 <screen>
185 $ ./configure --enable-mlib
186 </screen>
187 Robisz to na własne ryzyko. Użytkownicy x86 powinni
188 <emphasis role="bold">nigdy</emphasis> nie używać mediaLib,
189 ponieważ w efekcie otrzymają kiepską wydajność MPlayera.
190 </para></listitem>
191 </itemizedlist>
193 <para>
194 Aby zbudować pakiet, będziesz potrzebował GNU <application>make</application>
195 (<filename>gmake</filename>, <filename>/opt/sfw/gmake</filename>), rdzenne make
196 Solarisa nie zadziała. Typowy błąd jaki otrzymujesz, budując tym drugim zamiast GNU
197 make, to:
198 <screen>
199    % /usr/ccs/bin/make
200    make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen
201 </screen>
202 </para>
204 <para>
205 W Solarisie przeznaczonym dla SPARC, potrzebujesz kompilatora GNU C/C++; nie ma
206 znaczenia, czy jest on skonfigurowany z, czy bez GNU assemblera.
207 </para>
209 <para>
210 Na Solarisie x86, potrzebujesz GNU assemblera i kompilatora GNU C/C++,
211 skonfigurowanego do używania GNU assemblera! Kod
212 <application>MPlayera</application>, na platformie x86, w znaczący sposób korzysta
213 z instrukcji MMX, SSE i 3DNOW!, które nie mogą być skompilowane przy pomocy
214 assemblera Sun <filename>/usr/ccs/bin/as</filename>.
215 </para>
217 <para>
218 Skrypt <filename>configure</filename> stara się określić, jaki assembler
219 wywoływany jest przez komendę &quot;gcc&quot; (jeżeli próba zakończy się fiaskiem,
220 użyj opcji <option>--as=<replaceable>/gdziekolwiek/zainstalowałeś/gnu-as</replaceable></option>,
221 żeby określić gdzie skrypt <filename>configure</filename> może znaleźć GNU "as" w Twoim
222 systemie).
223 </para>
225 <para>Rozwiązania najczęstszych problemów:</para>
226 <itemizedlist>
227 <listitem><para>
228 Błąd jaki wyświetli <filename>configure</filename> na Solarisie x86,
229 używającym GCC bez GNU assemblera:
230 <screen>
231    % configure
232    ...
233    Checking assembler (/usr/ccs/bin/as) ... , failed
234    Please upgrade(downgrade) binutils to 2.10.1...
235 </screen>
236 (Rozwiązanie: Zainstaluj i używaj gcc skonfigurowanego z opcją <option>--with-as=gas</option>)
237 </para>
239 <para>
240 Typowy błąd, jaki otrzymasz przy próbie budowy kompilatorem GNU C, który nie używa GNU as:
241 <screen>
242    % gmake
243    ...
244    gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math
245         -fomit-frame-pointer  -I/usr/local/include   -o mplayer.o mplayer.c
246    Assembler: mplayer.c
247    "(stdin)", line 3567 : Illegal mnemonic
248    "(stdin)", line 3567 : Syntax error
249    ... more "Illegal mnemonic" and "Syntax error" errors ...
250 </screen>
251 </para>
252 </listitem>
254 <listitem><para><application>MPlayer</application> może się wysypać
255 podczas dekodowania i kodowania wideo używających win32codecs:
256 <screen>
258 Trying to force audio codec driver family acm...
259 Opening audio decoder: [acm] Win32/ACM decoders
260 sysi86(SI86DSCR): Invalid argument
261 Couldn't install fs segment, expect segfault
263 MPlayer interrupted by signal 11 in module: init_audio_codec
265 </screen>
266 Dzieje się tak z powodu zmian w sysi86() w Solaris 10 i wydaniach
267 pre-Solaris Nevada b31. Zostało to naprawione w Solaris Nevada b32;
268 jednak Sun nie przeniósł jeszcze poprawki do Solarisa 10. Projekt
269 MPlayer poinformował o tym problemie Sun i łatka jest aktualnie
270 wprowadzana do Solarisa 10. Więcej informacji o tym błędzie może
271 zostać znaleziona  na stronie:
272 <ulink
273    url="http://bugs.opensolaris.org/bugdatabase/view_bug.do?bug_id=6308413"/>.
274 </para>
275 </listitem>
277 <listitem><para>
278 Ze względu na błędy występujące w Solarisie 8, możesz nie być w stanie odtwarzać
279 płyt DVD o pojemności większej niż 4 GB:
280 </para>
282 <itemizedlist>
283 <listitem><para>
284 Sterownik sd(7D) dla Solarisa 8 x86 ma błąd ujawniający się przy próbie dostępu do
285 bloku dyskowego >4GB urządzenia korzystającego z logicznego rozmiaru bloku !=DEV_BSIZE
286 (np. nośnik CD-ROM i DVD). Ze względu na przepełnienie 32bitowych liczb całkowitych,
287 odczytywany jest adres dysku modulo 4GB
288 (<ulink url="http://groups.yahoo.com/group/solarisonintel/message/22516"/>).
289 Ten problem nie występuje na Solarisie 8 przeznaczonym dla procesorów SPARC.
290 </para></listitem>
292 <listitem><para>
293 Podobny błąd występuje w kodzie systemu plików hsfs(7FS) (znanym jako ISO9660),
294 hsfs może nie obsługiwać partycji/dysków większych niż 4GB, wszystkie dane są
295 odczytywane z bloku modulo 4GB
296 (<ulink url="http://groups.yahoo.com/group/solarisonintel/message/22592"/>).
297 Problem może być rozwiązany przy pomocy łatki 109764-04 (sparc) / 109765-04 (x86).
298 </para></listitem>
299 </itemizedlist>
300 </listitem>
301 </itemizedlist>
302 </sect2>
304 <sect2 id="hp-ux">
305 <title>HP-UX</title>
306 <para>
307 Joe Page umieścił na swojej stronie domowej
308 <ulink url="http://users.rcn.com/joepage/mplayer_on_hpux11.htm">dokument
309 HOWTO</ulink> stworzony przez Martina Gansser'a dotyczący <application>MPlayera</application>
310 na HP-UX. Korzystając z zawartych tam intrukcji program powinien się skompilować bez
311 najmniejszych problemów. Poniższe informacje są zaczerpnięte z tego opracowania.
312 </para>
315 <para>
316 Do budowy będziesz potrzebował GCC 3.4.0, GNU make 3.80, i SDL 1.2.7 lub ich
317 nowszych wersji. Kompilator HP cc nie wyprodukuje działającego programu,
318 a wcześniejsze wersje GCC są pełne błędów.
319 Aby moć skorzystać z OpenGL, musisz zainstalować biblioteki Mesa, wtedy
320 sterowniki wyjścia video gl i gl2 powinny działać. Ich wydajność może być
321 tragiczna, jednak zależne jest to od mocy obliczeniowej procesora. Dobrym
322 zamiennikiem, raczej kiepskiego, systemu dźwiękowego HP-UX jest GNU esound.
323 </para>
325 <para>
326 Stwórz urządzenie DVD, przeskanuj magistralę SCSI komendą:
327 </para>
329 <screen>
330 # ioscan -fn
332 Class          I            H/W   Path          Driver    S/W State    H/W Type        Description
334 ext_bus 1    8/16/5      c720  CLAIMED INTERFACE  Built-in SCSI
335 target  3    8/16/5.2    tgt   CLAIMED DEVICE
336 disk    4    8/16/5.<emphasis role="bold">2</emphasis>.<emphasis role="bold">0</emphasis>  sdisk CLAIMED DEVICE     <emphasis role="bold">PIONEER DVD-ROM DVD-305</emphasis>
337                          /dev/dsk/c1t2d0 <emphasis role="bold">/dev/rdsk/c1t2d0</emphasis>
338 target  4    8/16/5.7    tgt   CLAIMED DEVICE
339 ctl     <emphasis role="bold">1</emphasis>    8/16/5.7.0  sctl  CLAIMED DEVICE     Initiator
340                          /dev/rscsi/c1t7d0 /dev/rscsi/c1t7l0 /dev/scsi/c1t7l0
342 </screen>
344 <para>
345 Z rezultatów działania komendy możemy odczytać, że na adresie 2 SCSI znajduje
346 się Pioneer DVD-ROM. Instancja karty dla ścieżki sprzętowej 8/16 to 1.
347 </para>
349 <para>
350 Stwórz dowiązanie surowego urządzenia do urządzenia DVD.
351 </para>
353 <screen>
354 # ln -s /dev/rdsk/c<replaceable>&lt;instancja magistrali SCSI&gt;</replaceable>t<replaceable>&lt;ID docelowego SCSI&gt;</replaceable>d<replaceable>&lt;LUN&gt;</replaceable> /dev/<replaceable>&lt;urządzenie&gt;</replaceable>
355 </screen>
357 <para>
358 Przykład:
359 </para>
361 <screen>
362 # ln -s /dev/rdsk/c1t2d0 /dev/dvd
363 </screen>
365 <para>
366 Poniżej znajdują się rozwiązania kilku najczęstszych problemów:
367 </para>
369 <itemizedlist>
370 <listitem>
371 <para>
372 Wysypanie się programu przy uruchamianiu z komunikatem błędu:
373 <screen>
374 /usr/lib/dld.sl: Unresolved symbol: finite (code) from /usr/local/lib/gcc-lib/hppa2.0n-hp-hpux11.00/3.2/../../../libGL.sl
375 </screen>
376 </para>
378 <para>
379 Oznacza to, że funkcja <systemitem>.finite().</systemitem> jest niedostępna
380 w standardowej bibliotece math HP-UX.
381 Zamiast niej dostępna jest <systemitem>.isfinite().</systemitem>.
382 Rozwiązanie: Skorzystaj z najnowszego pliku składowego Mesa.
383 </para>
384 </listitem>
386 <listitem>
387 <para>
388 Wysypanie się programu przy odtwarzaniu z komunikatem:
389 <screen>
390 /usr/lib/dld.sl: Unresolved symbol: sem_init (code) from /usr/local/lib/libSDL-1.2.sl.0
391 </screen>
392 </para>
394 <para>
395 Rozwiązanie: Skorzystaj z opcji extralibdir skryptu configure
396 <option>--extra-ldflags="/usr/lib -lrt"</option>
397 </para>
398 </listitem>
400 <listitem>
401 <para>
402 MPlayer powoduje błąd naruszenia ochrony pamięci (segfault) z komunikatem:
403 <screen>
404 Pid 10166 received a SIGSEGV for stack growth failure.
405 Possible causes: insufficient memory or swap space, or stack size exceeded maxssiz.
406 Segmentation fault
407 </screen>
408 </para>
410 <para>
411 Rozwiazanie:
412 Jądro HP-UX ma domyślnie zdefiniowany rozmiar stosu przeznaczonego na każdy
413 proces i jest to 8MB(?).(11.0 i nowsze łatki 10.20 pozwalają Ci zwiększyć
414 parametr <systemitem>maxssiz</systemitem> do 350MB dla 32-bitowych programów).
415 Musisz rozszerzyć <systemitem>maxssiz</systemitem> i przekompilować jądro
416 (i uruchomić ponownie komputer). Możesz wykorzystać do tego celu SAM. (Kiedy
417 w nim będziesz, sprawdź wartość <systemitem>maxdsiz</systemitem>. Określa ona
418 maksymalny rozmiar danych, jaką program może użyć. To czy domyślne 64MB wystarczy
419 czy nie, zależy wyłącznie od wymagań Twoich aplikacji.)
420 </para>
421 </listitem>
422 </itemizedlist>
424 </sect2>
426 <sect2 id="aix">
427 <title>AIX</title>
428 <para>
429 <application>MPlayer</application> kompiluje się z powodzenie na AIX 5.1,
430 5.2 i 5.3, korzystając z GCC 3.3 lub wyższego. Budowanie
431 <application>MPlayer</application> na AIX 4.3.3 i niższych nie
432 było sprawdzane. Zaleca się, abyś budowal <application>MPlayera</application>
433 używając GCC 3.4 lub wyższego lub jeżeli kompilujesz na POWER5 - GCC 4.0.
434 </para>
436 <para>
437 Upenij się, że używasz GNU make (<filename>/opt/freeware/bin/gmake</filename>), aby
438 kompilować <application>MPlayera</application>, jako że możesz napotkać na problemy
439 przy korzystaniu z <filename>/usr/ccs/bin/make</filename>.
440 </para>
441 <para>
442 Wykrywanie CPU jest ciągle dopracowywane.
443 Poniższe architektury zostały przetestowane:
444 </para>
446 <itemizedlist>
447 <listitem><para>604e</para></listitem>
448 <listitem><para>POWER3</para></listitem>
449 <listitem><para>POWER4</para></listitem>
450 </itemizedlist>
452 <para>
453 Poniższe architektury nie były testowane, ale i tak powinny działać:
454 </para>
455 <itemizedlist>
456 <listitem><para>POWER</para></listitem>
457 <listitem><para>POWER2</para></listitem>
458 <listitem><para>POWER5</para></listitem>
459 </itemizedlist>
461 <para>
462 Dźwięk przez Ultimedia Services nie jest obsługiwany, jako że ta technologia
463 została porzucona w AIX 5.1; dlatego też, jedynym wyjściem jest korzystanie
464 ze sterowników AIX Open Sound System (OSS) tworzonych przez 4Front Technologies,
465 znajdziesz je na
466 <ulink url="http://www.opensound.com/aix.html">http://www.opensound.com/aix.html
467 </ulink>.
468 4Front Technologies udostępnia swoje sterowniki OSS za darmo do niekomercyjnego
469 zastosowania; jednakże, nie ma aktualnie sterowników wyjścia audio dla AIX 5.2 lub 5.3.
470 Oznacza to, że <emphasis role="bold">AIX 5.2 i 5.3 nie potrafią aktualnie używać
471 wyjścia audio MPlayera.</emphasis>
472 </para>
474 <para>Rozwiązania częstych problemów:</para>
476 <itemizedlist>
477 <listitem>
478 <para>
479 Jeżeli otrzymujesz od <filename>configure</filename> taki komunikat błędu:
480 <screen>
481 $ ./configure
483 Checking for iconv program ... no
484 No working iconv program found, use
485 --charset=US-ASCII to continue anyway.
486 Messages in the GTK-2 interface will be broken then.
487 </screen>
488 To dzieje się tak dlatego, że AIX używa nie standardowych
489 zestawów nazw znaków; dlatego też, konwersja wyjścia MPlayera
490 do innego zestawu znaków (kodowania) nie jest aktualnie obsługiwana.
491 Rozwiązaniem jest użycie:
492 <screen>
493 $ ./configure --charset=noconv
494 </screen>
495 </para>
496 </listitem>
497 </itemizedlist>
499 </sect2>
501 <sect2 id="qnx">
502 <title>QNX</title>
503 <para>
504 Będziesz musiał ściągnąć bibliotekę SDL dla QNX i zainstalować ją. Wtedy
505 uruchom <application>MPlayera</application> z opcją
506 <option>-vo sdl:driver=photon</option>
507 i <option>-ao sdl:nto</option>, powinno działać szybko.
508 </para>
510 <para>
511 Wyjście <option>-vo x11</option> będzie nawet wolniejsze niż na Linuksie,
512 ponieważ QNX ma tylko <emphasis>emulację</emphasis> X'ów, która jest bardzo
513 wolna.
514 </para>
515 </sect2>
516 </sect1>
518 <sect1 id="windows">
519 <title>Windows</title>
521 <para>Tak, <application>MPlayer</application> działa na Windowsie pod
522   <ulink url="http://www.cygwin.com/"><application>Cygwinem</application></ulink> i
523   <ulink url="http://www.mingw.org/"><application>MinGW</application></ulink>.
524   Nie ma jeszcze oficjalnego interfejsu GUI, ale wersja dla wiersza poleceń jest już w pełni
525   funkcjonalna. Powinieneś sprawdzić listę
526   <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-cygwin/">MPlayer-cygwin</ulink>,
527   aby uzyskać pomoc albo otrzymać najnowsze informacje.
528   Oficjalne paczki z binariami dla Windowsa znajdziesz na
529   <ulink url="http://www.mplayerhq.hu/design7/dload.html">stronie pobierania</ulink>.
530   Pakiety zawierające instalatory i proste nakładki GUI dostępne są z zewnętrznych
531   źródeł, informacje o nich zebraliśmy w sekcji poświęconej Windowsowi na
532   <ulink url="http://www.mplayerhq.hu/design7/projects.html#windows">stronie projektów</ulink>.
533 </para>
535 <para>Jeżeli chcesz uniknąć korzystania z wiersza poleceń, prostym sposobem
536       na jego ominięcie jest umieszczenie skrótu na pulpicie, który będzie
537       zawierał podobny wpis w części odpowiedzialnej za wykonanie
538       komendy:
539       <screen><replaceable>c:\ścieżka\do\</replaceable>mplayer.exe %1</screen>
540       Spowoduje to, że <application>MPlayer</application> będzie odtwarzał
541       film, który zostanie przeciągnięty na jego skrót. Dodaj opcję
542       <option>-fs</option>, aby korzystać z trybu pełnoekranowego.
543 </para>
545 <para>Najlepsze wyniki są osiągane ze sterownikami wyjściowymi video DirectX
546   (<option>-vo directx</option>). Możesz skorzystać również z OpenGL lub SDL, jednak
547   wydajność OpenGL w znacznym stopniu zależy od systemu, a SDL może powodować powstanie
548   zakłóceń w obrazie albo wywołać błąd, i zakończyć działanie programu.
549   Jeżeli występują zakłócenia obrazu, spróbuj
550   wyłączyć sprzętową akcelerację przez opcję <option>-vo directx:noaccel</option>. Ściągnij
551   <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/contrib/dx7headers.tgz">pliki
552   nagłówkowe DirectX 7</ulink>, żeby skompilować sterownik do wyjścia video
553   DirectX. Co więcej, musisz mieć zainstalowany DirectX 7 lub nowszy,
554   aby to wyjście zadziałało.</para>
556 <para><link linkend="vidix">VIDIX</link> działa teraz również pod Windowsem jako
557   <option>-vo winvidix</option>, chociaż jego obsługa jest eksperymentalna i wymaga
558   trochę ręcznego przygotowania. Pobierz
559   <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/dhahelperwin/dhahelper.sys">dhahelper.sys</ulink>
560   lub
561   <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/dhahelperwin/withmtrr/dhahelper.sys">dhahelper.sys
562   (z obsługą MTRR)</ulink>
563   i skopiuj go do
564   <filename class="directory">libdha/dhahelperwin</filename> w drzewie źródłowym
565   <application>MPlayera</application>. Uruchom konsolę, następnie przejdź do tego katalogu i wykonaj
567   <screen>gcc -o dhasetup.exe dhasetup.c</screen>
569   i
571   <screen>dhasetup.exe install</screen>
573   jako Administrator. Będziesz musiał ponownie uruchomić komputer. Teraz, skopiuj wszystkie pliki
574   z rozszerzeniem <systemitem class="library">.so</systemitem> z katalogu
575   <filename class="directory">vidix/drivers</filename> do
576   <filename class="directory">mplayer/vidix</filename>
577   względem położnia pliku <filename>mplayer.exe</filename>.</para>
579 <para>Żeby osiągnąć najlepsze wyniki <application>MPlayer</application> powinien
580   korzystać z przestrzeni kolorów, którą Twoja karta wspomaga sprzętowo. Niestety
581   wiele sterowników graficznych Windowsa źle informuje o obsługiwanych przez kartę
582   przestrzeniach. Aby sprawdzić które są źle obsługiwane, wykonaj poniższą komendę:
584   <screen>mplayer -benchmark -nosound -frames 100 -vf format=<replaceable>przestrzeń</replaceable> <replaceable>film</replaceable></screen>
586   gdzie <replaceable>przestrzeń</replaceable> może być jakąkolwiek
587   wartością spośród tych uzyskanych przez opcję <option>-vf format=fmt=help</option>.
588   Jeśli któraś z nich działa szczególnie źle, opcja
589   <option>-vf noformat=<replaceable>przestrzeń</replaceable></option>
590   zapobiegnie jej używaniu. Możesz to na stałe dodać do Twojego pliku konfiguracyjnego.</para>
592 <para>Dostępne są specjalne zbiory z kodekami przeznaczone dla systemu Windows, znajdziesz je na
593   <ulink url="http://mplayerhq.hu/design7/codecs.html">stronie kodeków</ulink>.
594   Pozwolą Ci one na odtwarzanie formatów, które nie są jeszcze bezpośrednio obsługiwane w
595   <application>MPlayerze</application>. Umieść je, gdzieś w swojej ścieżce (w katalogu podanym w
596   zmiennej PATH - przyp. tłumacza) lub przekaż opcję
597   <option>--codecsdir=<replaceable>c:/ścieżka/do/Twoich/kodeków</replaceable></option>
598   (lub, tylko w środowkisku Cygwin,
599   <option>--codecsdir=<replaceable>/ścieżka/do/Twoich/kodeków</replaceable></option>)
600   do skryptu <filename>configure</filename>.
601   Mieliśmy doniesienia, że biblioteki Real, muszą być zapisywalne dla użytkownika, który
602   uruchamia <application>MPlayera</application>, ale tylko na niektórych systemach (NT4).
603   Spróbuj nadać im atrybut zapisywalności.</para>
605 <para>Możesz odtwarzać VCD, odtwarzając pliki <filename>.DAT</filename> lub <filename>.MPG</filename>,
606   które Windows pokazuje na VCD. To działa mniej więcej tak (dopasuj literę dysku do Twojego
607   CD-ROMu):</para>
609 <screen>mplayer <replaceable>d:/mpegav/avseq01.dat</replaceable></screen>
611 <para>DVD również działa, podaj literę Twojego DVD-ROMu przez
612   opcję <option>-dvd-device</option>:</para>
614 <screen>mplayer dvd://<replaceable>&lt;tytuł&gt;</replaceable> -dvd-device <replaceable>d</replaceable>:</screen>
616 <para>Konsola <application>Cygwin</application>/<application>MinGW</application>
617   jest raczej wolna. Zgłoszono, że przekierowywanie wyjścia albo używanie
618   opcji <option>-quiet</option> poprawia wydajność na
619   niektórych systemach. Bezpośrednie renderowanie (<option>-dr</option>) również
620   może pomóc. Jeżeli odtwarzanie jest nierówne, spróbuj użyć
621   <option>-autosync 100</option>. Jeżeli którakolwiek z tych opcji Ci pomogła,
622   może będziesz chciał umieścić ją w swoim pliku konfiguracyjnym.</para>
624 <note>
626 <para>Na Windowsie automatyczne wykrywanie typu procesora
627   wyłącza rozszerzenie SSE z powodu okazjonalnych i ciężkich
628   do wyśledzenia błędów powodujących zakończenie aplikacji. Jeżeli
629   nadal chesz mieć obsługę SSE pod Windowsem, będziesz musiał
630   skompilować program bez wykrywania typu CPU w trakcie działania.
631 </para>
633 <para>Jeżeli masz Pentium 4 i program wysypuje Ci się podczas używania
634   kodeków RealPlayer'a, prawdopodobnie będziesz musiał wyłączyć
635   obsługę hyperthreading'u.
636 </para>
637 </note>
641 <sect2 id="cygwin">
642 <title><application>Cygwin</application></title>
644 <para>Aby skompilować <application>MPlayera</application> wymagana jest wersja
645     <application>Cygwina</application> 1.5.0 lub późniejsza.</para>
647 <para>Pliki nagłówkowe DirectX muszą być rozpakowane do
648   <filename class="directory">/usr/include/</filename> lub
649   <filename class="directory">/usr/local/include/</filename>.</para>
651 <para>Instrukcje i pliki potrzebne do kompilacji SDLa dla <application>Cygwin</application>
652   są dostępne na
653   <ulink url="http://www.libsdl.org/extras/win32/cygwin/">stronie libsdl</ulink>.</para>
655 </sect2>
657 <sect2 id="mingw">
658 <title><application>MinGW</application></title>
660 <para>Zainstalowanie <application>MinGW</application>, który umożliwiłby
661   kompilację <application>MPlayera</application> było zawiłe,
662   ale teraz składa się tylko z trzech prostych kroków i niedługo powinno
663   działać "prosto z pudełka". Zainstaluj <application>MinGW</application>
664   3.0.0 lub nowszy. Zainstaluj MSYS 1.0.9 lub nowszy i wskaż systemowi poinstalacyjnemu
665   MSYSa, że <application>MinGW</application> jest zainstalowane.</para>
667 <para>Rozpakuj pliki nagłówkowe DirectX do <filename class="directory">/mingw/include/</filename>.</para>
669 <para>Do obsługi skompresowanych nagłówków MOV wymagana jest biblioteka
670   <ulink url="http://www.gzip.org/zlib/">zlib</ulink>, która nie jest
671   domyślnie dostępna w <application>MinGW</application>.
672   Skonfiguruj ją z opcją <option>--prefix=/mingw</option> i zainstaluj
673   przed kompilacją <application>MPlayera</application>.</para>
675 <para>Pełną instrukcję jak zbudować <application>MPlayera</application>
676   i wszystkie potrzebne biblioteki znajdziesz w
677   <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/contrib/MPlayer-MinGW-Howto.txt">MPlayer MinGW HOWTO</ulink>.</para>
679 </sect2>
681 </sect1>
682 <sect1 id="macos">
683 <title>Mac OS</title>
685 <para>
686 "Surowe" źródła <application>MPlayera</application> obsługują
687 tylko Mac OS X w wersjach 10.2 i wyższych. Możesz spróbować umożliwić
688 obsługę starszych wersji Mac OS oraz przysłać nam łaty!
689 <application>MPlayer</application> nie działa na Mac OS w wersjach niższych niż
690 10, jednak powinien skompilować się bez problemu na systemie Mac OS X 10.2 i
691 wyższym. Zalecanym kompilatorem jest GCC 3.x w wersji Apple.
692 Możesz otrzymać podstawowe środowisko do kompilacji, instalując
693 <ulink url="http://developer.apple.com/tools/download/">Xcode</ulink> od Apple.
694 Jeżeli masz Mac OS X 10.3.9 lub późniejszy i QuickTime 7, możesz
695 skorzystać ze sterownika wyjścia video <option>corevideo</option>.
696 </para>
698 <para>
699 Niestety, to podstawowe środowisko ni epozwoli ci na skorzystanie ze
700 wszystkich fajnych możliwości <application>MPlayera</application>.
701 Przykładowo, żeby uzyskać wkompilowaną obsługę OSD, będziesz
702 potrzebował bibliotek <systemitem class="library">fontconfig</systemitem>
703 i <systemitem class="library">freetype</systemitem>
704 zainstalowanych na swojej maszynie.
705 W przeciwieństwie do innych Uniksów, takich jak większość odmian
706 Linuksa i BSD, OS X nie ma systemu pakietów dostarczanego razem
707 z systemem.
708 </para>
710 <para>
711 Można wybierać spośród co najmniej dwóch systemów pakietów:
712 <ulink url="http://fink.sourceforge.net/">Fink</ulink> i
713 <ulink url="http://darwinports.opendarwin.org/">DarwinPorts</ulink>.\
714 Oba dostarczają takie same usługi (np. dużo pakietów do wyboru,
715 rozwiązywanie zależności, możliwość łatwego dodania/aktualizacji/usunięcia
716 pakietów itp.).
717 Fink oferuje zarówno binarne pakiety, jak i możliwość zbudowania wszystkiego
718 ze źródeł. Natomiast DarwinPorts pozwala tylko na budowanie ze źródeł.
719 Autorzy tego przewodnika wybrali DarwinPorts z powodu tej prostej przyczyny,
720 że jego podstawowa wersja była lżejsza.
721 Podane przykłady będą oparte na DarwinPorts.
722 </para>
724 <para>
725 Przykładowo, żeby skomilować <application>MPlayera</application> z obsługą
726 OSD:
727 <screen>sudo port install pkgconfig</screen>
728 Zainstaluje to <application>pkg-config</application>, który jest systemem
729 do zarządzania flagami kompilacji/dowiązań bibliotek.
730 <application>MPlayerowy</application> skrypt
731 <systemitem>configure</systemitem>używa go do prawidłowego
732 wykrywania bibliotek.
733 Następnie możesz zainstalować <application>fontconfig</application>
734 w podobny sposób:
735 <screen>sudo port install fontconfig</screen>
736 Następnie możesz uruchomić <application>MPlayerowy</application> skrypt
737 <systemitem>configure</systemitem> (zapisz zmienne systemowe
738 <systemitem>PKG_CONFIG_PATH</systemitem>
739 i <systemitem>PATH</systemitem>, żeby
740 <systemitem>configure</systemitem> znalazł biblioteki zainstalowane
741 przez DarwinPorts):
742 <screen>PKG_CONFIG_PATH=/opt/local/lib/pkgconfig/ PATH=$PATH:/opt/local/bin/ ./configure</screen>
743 </para>
745 <sect2 id="osx_gui">
746 <title>MPlayer OS X GUI</title>
747 <para>
748 Możesz pobrać natywne GUI dla <application>MPlayera</application> razem
749 z prekompilowanymi binariami <application>MPlayera</application> dla
750 Mac OS X ze strony projektu
751 <ulink url="http://mplayerosx.sf.net/">MPlayerOSX</ulink>, ale uwaga:
752 projekt nie jest już aktywny.
753 </para>
754 <para>
755 Na szczęście, <application>MPlayerOSX</application> został przejęty
756 przez członka załogi <application>MPlayera</application>.
757 Wersje testowe są dostępne na stronie z
758 <ulink url="http://mplayerhq.hu/dload.html">materiałami do
759 pobrania</ulink>, a oficjalne wydanie powinno pojawić się już
760 niedługo.
761 </para>
762 <para>
763 Aby zbudować <application>MPlayerOSX</application> bezpośrednio
764 ze źródeł, potrzebujesz modułu <systemitem>mplayerosx</systemitem>,
765 <systemitem>main</systemitem> i kopii modułu CVS
766 <systemitem>main</systemitem> o nazwie
767 <systemitem>main_noaltivec</systemitem>.
768 <systemitem>mplayerosx</systemitem> to graficzna nakładka,
769 <systemitem>main</systemitem> to MPlayer, a
770 <systemitem>main_noaltivec</systemitem> to MPlayer zbudowany bez obsługi
771 AltiVec.
773 </para>
774 <para>
775 Aby pobrać moduł z repozytorium SVN wykonaj polecenia:
776 <screen>
777 svn checkout svn://svn.mplayerhq.hu/mplayerosx/trunk/ mplayerosx
778 svn checkout svn://svn.mplayerhq.hu/mplayer/trunk/ main
779 </screen>
780 </para>
781 <para>
782 W celu zbudowania <application>MPlayerOSX</application> będziesz musiał
783 utowrzyć podobną strukturę katalogów:
784 <screen>
785 katalog_źródłowy_MPlayera
786    |
787    |--->main           (źródła MPlayera z Subversion)
788    |
789    |--->main_noaltivec (źródła MPlayera z Subversion skonfigurowane z opcją --disable-altivec)
790    |
791    |--->mplayerosx     (źródła MPlayer OS X z Subversion)
792 </screen>
794 Najpierw musisz zbudować main i main_noaltivec.
795 </para>
797 <para>
798 Następnie ustaw globalną zmienną:
800 <screen>export MACOSX_DEPLOYMENT_TARGET=10.3</screen>
801 </para>
803 <para>
804 Potem skonfiguruj:
805 </para>
806 <para>
807 Jeżeli konfigurujesz dla maszyny G4 lub lepszej z obsługą AltiVec,
808 postępuj jak poniżej:
809 <screen>
810 ./configure --with-termcaplib=ncurses.5 --disable-gl --disable-x11
811 </screen>
813 Jeżeli konfigurujesz dla maszyny z procesorem G3 bez AltiVec,
814 postępuj jak ponieżej:
815 <screen>
816 ./configure --with-termcaplib=ncurses.5 --disable-gl --disable-x11
817 --disable-altivec
818 </screen>
819 Być może będziesz musiał wyedytować plik <filename>config.mak</filename>
820 i zmienić wartości <systemitem>-mcpu</systemitem>
821 <systemitem>-mtune</systemitem> z <systemitem>-74XX</systemitem> na
822 <systemitem>-G3</systemitem>.
823 </para>
824 <para>
825 Następnie wykonaj
826 <screen>
827 make
828 </screen>
829 przejdź do katalogu mplayerosx i wpisz
831 <screen>
832 make dist
833 </screen>
834 Zostanie utworzony skompresowany obraz <systemitem>.dmg</systemitem>
835 zawierający gotowy do uruchomienia program.
836 </para>
837 <para>
838 Możes również skorzystać z projektu <application>Xcode</application> 2.1;
839 stary projekt dla <application>Xcode</application> 1.x już nie działa.
841 </para>
842 </sect2>
843 </sect1>
845 </chapter>