mpv/DOCS/Polish

MPlayer - Movie Player for LINUX (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)
================================ * See the file AUTHORS for the complete list *
http://mplayer.sourceforge.net (or http://mplayer.dev.hu)

O programie:
~~~~~~
MPlayer jest odgrywarką filmów dla LINUXa. 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?

Historia:
~~~~~~~~
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ą....

- 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.
- 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++!!!)
- 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.
- 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.
- MPlayer v0.10:
  The MPEG and AVI player in a single binary!
- 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.
- 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.
- 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 !

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.

What about the GUI?
~~~~~~~~~~~~~~~~~~~
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!!!

Obsługiwane formaty wejścia:
~~~~~~~~~~~~~~~~~~~~~~~~
- VCD (Video CD) bezpośrednio z CD-ROMu lub z obrazu .bin 
- DVD, bezpośrednio z Twojej płyty DVD, opcjonalnie używając libcss do deszyfrowania
- MPEG 1/2 System Stream (PS/PES/VOB) i Elementary Stream (ES) 
- RIFF AVI file format
- ASF 1.0 file format
- obsługuje czytanie z pliku, stdin, DVD oraz sieci przez HTTP

Uwaga: o obsłudze quicktime (.mov/.qt) oraz realmedia (.ra/.rm) czytaj w FAQ-u!

Obsługiwanie kodeki audio i video
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*** Sprawdź http://mplayer.sourceforge.net/DOCS/codecs.html              ***
***       znajdziesz tam kompletną, codziennie odświeżaną listę!!!       ***

Najważniejsze kodeki video:
- MPEG1 (VCD) and MPEG2 (DVD) video
- DivX, OpenDivX i inne warianty MPEG4
- Windows Media Video 7 (WMV1) wykorzystywany w plikach .wmv
- Intel Indeo codecs (3.1,3.2,4.1,5.0)
- MJPEG, ASV2 oraz inne formaty sprzętowe

Najważniejsze kodeki audio:
- MPEG layer 2, and layer 3 (MP3) audio (natywny kod, z optymalizacjami 3dnow)
- AC3 dolby audio (natywny kod, z optymalizacjami 3dnow)
- Voxware audio
- alaw, msgsm, pcm and other simple old audio formats

Jeśli masz kodeka nie opisanego tutaj, oraz jeszcze nie obsługiwanego
przeczytaj 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ę.

Obsługiwane wyjścia video:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Ogólne:
- x11:	X11 z opcjonalnym rozszerzeniem SHM
- xv:	X11 używające rozszerzenia XVideo (sprzętowe YUV oraz skalowanie)
- gl:	renderer OpenGL, jak do tej pory działa jedynie z:
	- wszystkie karty z Utah-GLX
	- Karty Matroxa z X/DRI >=4.0.3
	- Radeon z X/DRI CVS
- dga:	rozszerzenie X11 DGA 
- fbdev:Wyjście na framebuffer
- svga: Wyjście do SVGAlib
- 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!)
- ggi: podobne do SDL

Specyficzne dla kart:
- mga:	Matrox G200/G400 hardware YUV overlay via the mga_vid device
- xmga:	Matrox G200/G400 overlay (mga_vid) in X11 window
	(Xv emulation on X 3.3.x !)
- syncfb: Matrox G400 YUV support on framebuffer (obsoleted, use mga/xmga)
- 3dfx:	Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)

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

UWAGA: sprawdź DOCS/VIDEOCARDS po szczególy i wymagania!

Obsługiwane urządzenia audio:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- OSS (ioctl) driver
- SDL driver (supports up/downsampling, esd, arts etc)
- native ALSA 0.5 driver
- native ALSA 0.9 driver (buggy, use OSS emulation!)
- native ESD driver (under development?)
- SUN audio driver (/dev/audio) for BSD and Solaris8 users

UWAGA: sprawdź DOCS/SOUNDCARDS po szczególy!

Prędkość:
~~~~~~
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

Użytkowanie:
~~~~~~
  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]

  Opcje:
    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

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

  Przykłady:
    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

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

Playing from Net & stdin:
~~~~~~~~~~~~~~~~~~~~~~~~~
Now it's possible.

To play something by reading from stdin, just use '-' as filename:

cat test.mpg | mplayer -vo xv -

Restrictions:
	mpg: no backward seeking
	asf: no backward seeking
	avi: no index reading -> no seeking at all, and playing of some files are
		+impossible

No control from controlling terminal/xterm, but hotkeys and osd works
from the window. or course LIRC still works everywhere.

This feature combined with external wrappers extends possibilities.
For example, to play a movie just downloaded from your favourite divx
server:
	rar p ast-nssvcd.rar | mplayer -vo xmga -fs -
or:
	wget ftp://micorsops.com/something.avi -O - | mplayer -


TV output:
~~~~~~~~~~
If you have a Matrox G400 Dual-Head card, you can watch movies on TV, using
the TV-out feature of the second head. Read DOCS/TVout-G400 for details!

Sending bugreports, comments, feature requests etc:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
First please read all the docs in this package, most of the problems are
described somewhere. At least read DOCS/BUGS !  We don't like answering
questions which are already answered in this readme or other docs.

Read the DOCS/MPlayer-FAQ. Most common problems are answered there!

You should try the latest development version (from CVS) too, maybe your
bug is already fixed, but the new version hasn't been released.
If you couldn't solve the problem, then send a quality bugreport:
read DOCS/BUGREPORTS for instructions (where, what and how...)

Subscribe to the mplayer-users mailing list. There are many MPlayer
users, maybe they can help or know the solution to your problem.
You also should send ideas, feature requests, comments to there!
Please do not ask for features already listed in the DOCS/TODO!

Contact information:
~~~~~~~~~~~~~~~~~~~~
Homepage:  http://mplayer.sourceforge.net

Mailing lists:
~~~~~~~~~~~~~~
There are some public mailing lists on MPlayer. Subscribing can be achieved on
the following addresses:

- MPlayer core/hungarian developers list:
	http://lists.sourceforge.net/lists/listinfo/mplayer-devel

	I dunno, it is the FLAME list in hungarian language :)
	Also some talking about mplayer core team internals, like mplayer
	party, sponsors etc can be here.

- MPlayer developers list:
	http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng

	This list is about mplayer development! Talking about interface/API changes,
	new libraryes, code optimization, ./configure changes, and send patches here.
	Do NOT send bugreports, user questions, feature requests here!
	This list should be kept low-traffic.

- MPlayer users list:  
	http://lists.sourceforge.net/lists/listinfo/mplayer-users

	- send bugreports here (after reading DOCS/BUGS, BUGREPORTS)
	- send feature requests here (after reading DOCS/TODO)
	- send user questions here (after reading DOCS/README, INSTALL, FAQ etc)

- MPlayer & Matrox G200/G400/G450 users:
	http://lists.sourceforge.net/lists/listinfo/mplayer-matrox

	Send matrox-related questions here,
	- things about mga_vid,
	- matrox's official beta drivers (for X 4.x.x)
	- and about matroxfb-TVout stuff.

- mpg12play-portable developers:
	http://lists.sourceforge.net/lists/listinfo/mplayer-mpg12play

	This list is for talking about mplayer ports to non-x86 platforms
	(IRIX, Solaris-SPARC, Alpha, Commodore64, Sharp Calculator,
	Teapot etc...)

- MPlayer announce:    
	http://lists.sourceforge.net/lists/listinfo/mplayer-announce

	Very low traffic list :)
	And it's read-only. I'll post something shit there if a new release
	is done.

- MPlayer CVS-log:     
	http://lists.sourceforge.net/lists/listinfo/mplayer-cvslog

	Send only questions about CVS changes here.
	(if you don't understand why a change is required or you've better fix)
	Be sure in that your target developer reads this list!

NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise.
      Please do not send messages using other language!

License:
~~~~~~~~
MPlayer incorporates a lot of code from other projects, but for now everything
except the OpenDivX stuff is under General Public License (GPL) version 2 or
later.

Standard Disclaimer:
~~~~~~~~~~~~~~~~~~~~
Use only at your own risk! There may be errors and inaccuracies that could
damage your system, your eye or ear. Proceed with caution, and although this is
highly unlikely, we don't take any responsibility for that!