in-progress polish docs for mplayer. please be gentle.

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@1233 b3059339-0415-0410-9bf9-f77b7e298cf2

1 files changed, 312 insertions, 0 deletions

diff --git a/DOCS/Polish/README b/DOCS/Polish/README
new file mode 100644
index 0000000000..d32e92baf5
--- /dev/null
+++ b/DOCS/Polish/README
@@ -0,0 +1,312 @@
+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!