annotate DOCS/Polish/documentation.sgml @ 2728:96c1d1e6cb9e

only 6 registers used

<!doctype linuxdoc system>

<!-- This is a test -->

<article>

<!-- Title information -->

<title>
MPlayer - Movie Player for LINUX (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)
<url url="http://www.mplayerhq.hu/homepage/">
</title>
<author>
 <name>
 oparte na dokumentacji napisanej przez Gábor Bérczi (Gabucino)
 <tt/&lt;[e-mail]/&gt;
       <newline></name>
  <and>
 <name>tłumaczenie i migracja do linuxdoc Dariush Pietrzak<tt/&lt;[e-mail]/&gt;
       <newline></name>
</author>
<date>$Id$</date>

<abstract>
Dokument ten opisuje odgrywarke MPlayer, dokument jest w fazie testów.
<url url="http://mplayer.dev.hu/">
</abstract>

<!-- Table of contents -->
<toc>

<!-- Begin the document -->

<sect>
<heading>Wprowadzenie</>


<sect1>
<heading>O programie</>
<p>

<bf>MPlayer</> jest odgrywarką filmów. Wyświetla większość plików MPEG,
AVI oraz ASF korzystając z wielu własnych oraz Win32 DLL kodeków.
Możesz również oglądać VCD, DVD oraz filmy w DivX. Kolejną dużą zaletą
mplayera jest szeroki wachlarz sterowników wyjścia. Mplayer działa z X11, Xv,
DGA, OpenGL, SVGAlib, fbdev, ale możesz też korzystać z GGI iSDL ( i w ten sposób
z wielu sterowników dostarczanych przez SDL - na przykład AAlib ) oraz z 
niskopoziomowych sterowników specyficznych dla danej karty (dla Matrox G200/400/450).
 Większość dostępnych sterowników udostępnia softwarowe lub hardwarowe skalowania,
możesz więc radować się oglądaniem film w trybie pełnoekranowym.
 A co powiesz na duże antyaliasowane podtytuły z cieniem ( 7 supportowanych typów!!)
z węgierskimi, angielskimi, czeskimi, koreańskimi fontami, cyrylicą oraz OSD?


  I didn't write any codecs, just some players. I spent
  a lot of time finding the best way to parse bad damaged input files
  (both MPEG and AVI) and to do perfect A-V sync with seeking ability.
  My player is rock solid playing damaged MPEG files (useful for some VCDs),
  and it plays bad AVI files which are unplayable with the famous
  windows media player. Even AVI files without index chunk are playable, and
  you can rebuild their indexes with the -idx option, thus enabling seeking!
  As you see, stability and quality are the most important things for me,
  but the speed is also amazing.

</p>
</sect1>

<sect1>
<heading>Historia</>
<p>
Wszystko zaczęło się rok temu...(2000)
Próbowałem wielu odgrywarek pod linuxa (mtv,xmps,dvdview,livid/oms,VideoLAN,
xine,xanim,avifile,xmmp) ale każda miała jakiś feler. Głównie w przypadku
szczególnych plików lub z synchronizacją audio/video. Większość z nich nie
potrafiła odgrywać zarówno plików MPEG1/2 jak i AVI(DivX). Wiele z nich
miało również problemy z jakością obrazu oraz prędkoscią.
Postanowiłem więc napisać/zmodyfikować nową....

<itemize>

<item>mpg12play v0.1-v0.3:
  The first try, hacked together in a half hour!
  I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3,
  but there were image quality and speed problems with it.
<item>mpg12play v0.5-v0.87:
  Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
  but it was slow and was written in C++ (I hate C++!!!)
<item>mpg12play v0.9-v0.95pre5:
  Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
  It's great, optimized very fast C code with perfect image quality and
  100% MPEG standard conformance.
<item>MPlayer v0.3-v0.9:
  It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI
  player 'avip' based on avifile's Win32 DLL loader.
<item>MPlayer v0.10:
  The MPEG and AVI player in a single binary!
<item>MPlayer v0.11:
  Some new developers joined and from 0.11 the mplayer project is a team-work!
  Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding.
<item>MPlayer v0.17 "The IdegCounter"
  The release version of the 0.11pre after 4 months of heavy development!
  Try it, and be amazed! Thousands of new features added... and of course
  old code was improved too, bugs removed etc.
<item>MPlayer 0.18 "The BugCounter"
  2 months since 0.17 and here's a new release.. Completed ASF support,
  more subtitle formats, introduced libao (similar to libvo but to audio),
  even more stable than ever, and so on. It's a MUST !
</itemize>


As you see, I didn't write any codecs, just some players. Instead I spent
a lot of time finding the best way to parse bad damaged input files
(both MPEG and AVI) and to do perfect A-V sync with seeking ability.
My player is rock solid playing damaged MPEG files (useful for some VCDs),
and it plays bad AVI files which are unplayable with the famous
windows media player. Even AVI files without index chunk are playable, and
you can rebuild their indexes with the -idx option, thus enabling seeking!
As you see, stability and quality are the most important things for me,
but the speed is also amazing.

</p>

</sect1>
<sect1>
<heading>Installation</>
</sect1>
<sect1>
<heading>What about the GUI?</>
<p>
I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
So the player has only keyboard control from the controlling console/xterm now.
There is a GUI development for the player, coordinated by Pontscho/Fresh!
It's still under development, but it will be merged and released real soon.
BTW he needs some nice skins, if you are a good graphician, contact him!!!



</p>
</sect1>

</sect>


<sect>
<heading>Features </>

<sect1>
	<heading>Obsługiwane formaty wejścia </>
	<p>
	<itemize>
	<item>VCD (Video CD) bezpośrednio z CD-ROMu lub z obrazu .bin 
	<item>DVD, bezpośrednio z Twojej płyty DVD, opcjonalnie używając libcss do deszyfrowania
	<item>MPEG 1/2 System Stream (PS/PES/VOB) i Elementary Stream (ES) 
	<item>RIFF AVI file format
	<item>ASF 1.0 file format
	<item>obsługuje czytanie z pliku, stdin, DVD oraz sieci przez HTTP
	</itemize>
	Uwaga: o obsłudze quicktime (.mov/.qt) oraz realmedia (.ra/.rm) czytaj w FAQ-u!
	</p>
</sect1>
<sect1>
	<heading>Obsługiwanie kodeki audio i video</>
	<p>
		<tscreen>
		Sprawdź <url url="http://mplayer.sourceforge.net/DOCS/codecs.html">      
		znajdziesz tam kompletną, codziennie odświeżaną listę!!!      
		</tscreen>
	<itemize>Najważniejsze kodeki video:
	<item>MPEG1 (VCD) and MPEG2 (DVD) video
	<item>DivX, OpenDivX i inne warianty MPEG4
	<item>Windows Media Video 7 (WMV1) wykorzystywany w plikach .wmv
	<item>Intel Indeo codecs (3.1,3.2,4.1,5.0)
	<item>MJPEG, ASV2 oraz inne formaty sprzętowe
	</itemize>
<itemize>Najważniejsze kodeki audio:
	<item>MPEG layer 2, and layer 3 (MP3) audio (natywny kod, z optymalizacjami 3dnow)
	<item>AC3 dolby audio (natywny kod, z optymalizacjami 3dnow)
	<item>Voxware audio
	<item>alaw, msgsm, pcm and other simple old audio formats
</itemize>


Jeśli masz kodeka nie opisanego tutaj, oraz jeszcze nie obsługiwanego
przeczytaj <url url="http://mplayer.sourceforge.net/DOCS/codecs.html"> oraz DOCS/CODECS
by uzyskać informacje jego statusie oraz jak można nam pomóc dodać dla
niego obsługę.

	</p>
</sect1>



<sect1>
 <heading>Obsługiwane wyjścia video </>
<p>

Ogólne:
<itemize>
<item>x11:	X11 z opcjonalnym rozszerzeniem SHM
<item>xv:	X11 używające rozszerzenia XVideo (sprzętowe YUV oraz skalowanie)
<item>gl:	renderer OpenGL, jak do tej pory działa jedynie z:
	<itemize>
	<item>wszystkie karty z Utah-GLX
	<item>Karty Matroxa z X/DRI >=4.0.3
	<item>Radeon z X/DRI CVS
	</itemize>
<item>dga:	rozszerzenie X11 DGA 
<item>fbdev:Wyjście na framebuffer
<item>svga: Wyjście do SVGAlib
<item>sdl:	1.1.7 : osbługuje softwarowe skalowanie
	1.1.8 : obsługuje Xvideo (sprzętowe skalowanie/fullscreen)
	1.2.0 : obsługuje aalib (tryb textowy!)
<item>ggi: podobne do SDL
</itemize>
Specyficzne dla kart:
<itemize>
<item>mga:	Matrox G200/G400 hardware YUV overlay via the mga_vid device
<item>xmga:	Matrox G200/G400 overlay (mga_vid) in X11 window
	(Xv emulation on X 3.3.x !)
<item>syncfb: Matrox G400 YUV support on framebuffer (obsoleted, use mga/xmga)
<item>3dfx:	Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)
</itemize>

Specjalne:
<itemize>
<item>png:  PNG files output (use -z switch to set compression)
<item>pgm:	PGM files output (for testing purposes or ffmpeg encoding)
<item>md5:	MD5sum output (for MPEG conformance tests)
<item>odivx:OpenDivX AVI File writer (use -br to set encoding bitrate)
<item>null:	Null output (for speed tests/benchmarking)
</itemize>

UWAGA: sprawdź DOCS/VIDEOCARDS po szczególy i wymagania!
</p>
</sect1>

<sect1>
 <heading>Obsługiwane urządzenia audio </>
<p>

<itemize>
<item>OSS (ioctl) driver
<item>SDL driver (supports up/downsampling, esd, arts etc)
<item>native ALSA 0.5 driver
<item>native ALSA 0.9 driver (buggy, use OSS emulation!)
<item>native ESD driver (under development?)
<item>SUN audio driver (/dev/audio) for BSD and Solaris8 users
</itemize>
UWAGA: sprawdź DOCS/SOUNDCARDS po szczególy!

</p>
</sect1>
<sect1>
 <heading>Prędkość </>
<p>
Większość krytycznych części jest optymalizowana dla MMX/MMXext/SSE/3DNow!/3DNow!Ex.
Możesz poprawić prędkość rednerowania ustawiająć rejestry MTRR, patrz dokumentacja w MTRR.
*Stare* benchmarki można znaleźć w pliku DOCS/SPEED
</p>
</sect1>
</sect>


<sect>
<heading> Użytkowanie </>

<p>
<verb>
  plik:  mplayer [options] [path/]filename
  VCD:   mplayer [options] -vcd trackno /dev/cdrom
  DVD:   mplayer [options] -dvdauth /dev/dvd filename.VOB
  sieć:   mplayer [options] http://site.com/file.[mpg|avi]
</verb>
</p>
<sect1>
 <heading>Opcje </>
<p>
<verb>
    patrz  `mplayer -h'  dla opcji
    patrz  `mplayer -vo help'  by zobaczyć listę dostępnych urządzeń video
    patrz  `mplayer -ao help'  by zobaczyć listę dostępnych urządzeń audio
</verb>
</p>
</sect1>

<sect1>
 <heading>Klawisze </>
<p>
<verb>
    &lt;-  lub  -&gt;      wyszukiwanie wprzód/wstecz o 10 sekund
    up lub down      seek backward/forward 1 minute
    p lub SPACE      pause movie (press any key to continue)
    q  lub  ^C       stop playing and quit program
    o               toggle OSD : none / seek / seek+timer
    /  oraz *        decrease/increase volume
    m               toggle using master/pcm channel for volume setting
    f               toggle fullscreen (only with -vo sdl)

</verb>

</p>
</sect1>
<sect1>
 <heading>Przykłady </>
<p>
<tscreen><verb>
    mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
    mplayer -vcd 2 /dev/cdrom
    mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
    mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob
    mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi
</verb></tscreen>

<bf>
  Uwaga: aby użyć urządzenia YUV Matroxa (-vo mga or xmga), będziesz najpierw musiał
         załadować sterownik do kernela: patrz DOCS/VIDEOCARDS .
</bf>


</p>
</sect1>

</sect>


<sect>
<heading> </>
<sect1>
 <heading> </>
<p>
</p>
</sect1>
</sect>




</article>