# HG changeset patch
# User gabucino
# Date 1007399289 0
# Node ID c21cea0a12aa52cc1cee7c5a2cbd00ce1b8b7845
# Parent e1cf5e6338a8f80d49bedb2de507999bd632ee35
enhanced Installation section
diff -r e1cf5e6338a8 -r c21cea0a12aa DOCS/Hungarian/documentation.html
--- a/DOCS/Hungarian/documentation.html Mon Dec 03 17:06:59 2001 +0000
+++ b/DOCS/Hungarian/documentation.html Mon Dec 03 17:08:09 2001 +0000
@@ -23,7 +23,7 @@
@@ -169,23 +169,23 @@
1.1. Röviden
Az MPlayer egy LINUXON működő videolejátszó (fut sok más Unix-on és
-akár nem-x86 processzorokon is. Lásd a 6-os fejezetet).
- Le tudja játszani a legtöbb MPEG, VOB, AVI, VIVO, ASF/WMV, QT/MOV file-t,
- és ezekhez felsorakoztat jónéhány natív, XAnim, és Win32 codecet. Nézhetsz vele
- VideoCD-t, SVCD-t, DVD-t, 3ivx-et, és még DivX-et is
- (ezutóbbihoz egyáltalán nincs szükség az avifile csomagra!). A másik óriási
- tulajdonsága az MPlayernek a megjelenítési módok széles választéka. Működik
- X11, Xv, DGA, OpenGL, SVGAlib, fbdev, aalib, sőt SDL-lel is (beleértve
- ezáltal az SDL drivereit is), és néhány alacsonyszintű kártyaspecifikus
- driver (Matrox/3dfx/SiS) is használható! Legtöbbjük támogat szoftveres vagy
- hardveres skálázást, így a teljesképernyős mód is elérhető. Az MPlayer
- támogat továbbá hardveres MPEG kártyákkal történő dekódolást/megjelenítést,
- így például aDVB és
- DXR3/Hollywood+
- kártyákon ! És még nem is szóltam a szép, élsímított, árnyékolt
- feliratozásról (9 támogatott típus!!!), ami támogat európai/ISO
- 8859-1,2 (magyar, angol, cseh, stb), cirill és koreai fontokat, valamint
- OSD-t!
+ akár nem-x86 processzorokon is. Lásd a 6-os fejezetet). Le
+ tudja játszani a legtöbb MPEG, VOB, AVI, VIVO, ASF/WMV, QT/MOV, FLI file-t,
+ és ezekhez felsorakoztat jónéhány natív, XAnim, és Win32 codecet. Nézhetsz
+ vele VideoCD-t, SVCD-t, DVD-t, 3ivx-et, és még
+ DivX-et is (ezutóbbihoz egyáltalán nincs szükség az avifile
+ csomagra!). A másik óriási tulajdonsága az MPlayernek a megjelenítési módok
+ széles választéka. Működik X11, Xv, DGA, OpenGL, SVGAlib, fbdev, aalib,
+ DirectFb, sőt SDL-lel vagy GGI-vel is (beleértve ezáltal az SDL/GGI drivereit
+ is), és néhány alacsonyszintű kártyaspecifikus driver (Matrox/3dfx/SiS) is
+ használható! Legtöbbjük támogat szoftveres vagy hardveres skálázást, így a
+ teljesképernyős mód is elérhető. Az MPlayer támogat továbbá hardveres
+ MPEG kártyákkal történő dekódolást/megjelenítést, így például aDVB és DXR3/Hollywood+ kártyákon !
+ És még nem is szóltam a szép, élsímított, árnyékolt feliratozásról (9
+ támogatott típus!!!), ami támogat európai/ISO 8859-1,2 (magyar, angol,
+ cseh, stb), cirill és koreai fontokat, valamint OSD-t!
Az MPlayer alapjában véve GPL, de tartalmaz néhány nem-GPL kódot is,
amit NEM lehet bináris formában terjeszteni, továbbá tartalmazza az OpenDivX
@@ -253,32 +253,49 @@
1.3. Installálás
+Ez a fejezet arra szolgál hogy segítsen véghezvinni az MPlayer fordítását
+és konfigurálását. Nem könnyű, de nem is szükségszerűen nehéz. Ha a leírtaktól
+eltérő viselkedést tapasztalsz, nézd át a dokumentációt és bizonyos hogy
+megtalálod a választ. A linkek azért vannak hogy alaposan elolvasd ahova
+mutatnak. Időigényes lesz, de megéri.
+
+Újabb keletű rendszer ajánlott. Linuxon a 2.4.x-es számú kernelek
+ajánlottak, de 2.4.10-zel és afölött problémák adódhatnak (licenszelés,
+kernel bugok, stb).
+
SZÜKSÉGES CSOMAGOK
A következő (és leírt verziójú) csomagokra lesz szükséged ha nem akarsz
problémákba ütközni:
- binutils - 2.11.x ajánlott. Ez a program felelős az
- MMX/3DNow!/stb utasításokért, ezért igen fontos.
+ MMX/3DNow!/stb utasításokért, ezért igen fontos.
- gcc - 2.95.2-től 2.95.4 verziók ajánlottak.
- SOHA ne használj 2.96-ot vagy 3.x.x-et !!! Hibás kódot generálnak.
+ SOHA ne használj 2.96-ot vagy 3.x.x-et !!! Hibás kódot generálnak.
+ Ha úgy döntesz hogy 2.96 helyett mást használsz, NE a 3.0 mellett
+ dönts, csak azért mert újabb! Sok tekintetben bugosabb is mint a 2.96.
+ Ígyhát ha váltani akarsz, marad a 2.95.x (2.95-ös libstdc++ is szükséges!),
+ vagy maradj a 2.96-nál (ebben az esetben viszont készülj fel a hibákra
+ a futás közben). A 2.96 "érdekességeiről"
+ itt vagy a FAQ-ban
+ találsz infot.
- XFree86 - mindig a legújabb (4.1.0) ajánlott. Normális
- esetben ez mindenképpen szükséges. Ha nem tudod miért, akkor tényleg
- muszáj. Bizonyosodj meg róla hogy fennvan a devel csomagja is !
+ esetben ez mindenképpen szükséges, tekintve hogy az újabb videokártyákban
+ jelenlevő hardveres YUV gyorsítás csak a 4.0.2-es verzió óta elérhető,
+ a benne levő XVideo kiterjesztés révén
+ (Xv-ként is fogok majd hivatkozni rá). Részletes
+ információ.
+ Bizonyosodj meg róla hogy fennvan a devel csomagja is !
+ Néhány kártyához az MPlayer különleges meghajtókat tartalmaz
+ amik XFree86 nélkül is hardveresen gyorsított lejátszást tesznek
+ lehetővé. Listát lásd lejjebb.
- make - mindig a legújabb ajánlott (legalább 3.79.x).
- Bár általában erre nem kell figyelj.
+ Bár általában erre nem kell figyelj.
- SDL - nem kötelező, de néhány esetben segíthet. Ajánlott mindig
- a legújabbat használni.
+ a legújabbat használni.
-Mielőtt sietnél fordítani, olvasd el a következőket is :
-
-
-- Ha 2.96-os GCC-d van (pl. RedHat 7.1, Mandrake 8), olvasd el
- ezt vagy a FAQ-t!
-
-
CODECEK
-DivX4 : ha használni akarod a ProjectMayo DivX4 codec-ét, nézd meg a
- 2.2.1.1-es fejezetet még fordítás előtt.
- Ez a codec sokkal gyorsabban játssza le a régi DivX filmeket mint a
- Win32-es codec. Ha az új DivX4 codec-ű filmeket is le akarod játszani,
- ajánlott ennek a könyvtárnak a használata a w32codecs.zip-ben található
- DivX.dll helyett. A codec maga zárt forráskódú, és egyelőre csak x86-os
- gépeken futtatható. Ez a codec szükséges a MEncoder-hez is,
- lásd lent !
+DivX4 : erről a codecről a
+ 2.2.1.1-es fejezetben található információ.
+ Ha nem akarsz MEncoder-t használni, ez a codec szükségtelen, tekintve
+ hogy a libavcodec (lásd fent) sokkal gyorsabb nála.
+ A DivX4 tulajdonságai :
+
+ - gyorsabban játszik le DivX3 filmeket mint a Win32-es DLL-ek,
+ de lassabban mint a libavcodec !
+ - A codec maga zárt forráskódú, és egyelőre csak x86-os
+ gépeken futtatható.
+ - Ez a codec szükséges a MEncoder-hez is,
+ lásd lent !
+
+
Ha 3ivx filmeket is le akarsz játszani, olvasd el az
XAnim codecek fejezetet.
+
+Az XAnim codecek a legjobbak a régebbi
+ codec-ű filmek (mint pl Indeo 3/4/5 vagy Cinepak) lejátszására (teljes
+ képernyő, hardveres YUV támogatás). Főleg hogy mivel több platformon
+ hozzáférhetők, ez az egyetlen lehetőség Indeo (stb) filmek lejátszására
+ nem-x86-os gépeken (mármint az Xanim használatán kívűl persze;).
+
VIDEOKÁRTYÁK
+Itt kétféle videokártyát különböztetünk meg. Az egyik fajta (az újabbak)
+rendelkezik hardveres YUV gyorsítással, a másik pedig nem.
+
+
+YUV kártyák
+
+
+Kevés CPU idő felhasználásával tudják
+megjeleníteni vagy nagyítani a képet. Itt a nagyítás ugyanannyi
+CPU időt használ mint a síma megjelenítés, tekintve hogy a videokártya
+végzi. Így a teljes képernyős lejátszás szép és gyors lesz.
+
-- Matrox G200/G400/G450/G550 kártyák : nézd meg a
- 2.3.1.7-es fejezetet, és nagy gyorsulást érhetsz el. Ezeket a lépéseket
- fordítás előtt kell megcsinálni, különben nem épül be Matrox támogatás az
+
- Matrox G200/G400/G450/G550 kártyák : a speciális mga_vid
+ meghajtó lehetővé teszi az Xv-nél sokkal gyorsabb megjelenítést, TV
+ kimenetet G400-on, mindezt akár XFree86 nélkül. Lásd a
+ 2.3.1.7-es fejezetet. Ezeket a lépéseket
+ fordítás előtt kell megtenni, különben nem épül be Matrox támogatás az
MPlayer-be. Olvasd el továbbá a Matrox
TV kimenet fejezetet.
@@ -337,28 +381,83 @@
fordítás előtt kell megcsinálni, különben nem épül be 3Dfx támogatás
az MPlayer-be. Nézd meg a 3dfx TV
kimenet fejezetet is.
+
+- S3 kártyák : a Savage chip-ek és az XFree86 meghajtó hozzájuk
+ támogatja a hardveres gyorsítást. A lehető legújabb XFree86 ajánlott, a
+ régebbi meghajtók hibásak. A Savage kártyáknak problémáik vannak az YV12
+ megjelenítéssel. Lásd az S3 Xv fejezetet.
+ Régi, nem-Savage chip-es kártyáknak nincs, vagy lassú a hardveres
+ támogatásuk.
+
+- Nvidia kártyák : nagyon rossz választás videolejátszásra. Ezek
+ a kártyák olcsó távolkeleti alkatrészekből készülnek, amik rossz képminőséget
+ adnak más kártyákhoz képest. Továbbá az XFree86-ban található Nvidia
+ meghajtó nem tartalmaz hardveres YUV gyorsítást! Ehhez le kell töltened
+ az Nvidia zárt forráskódú meghajtóját az nvidia.com-ről. Részleteket
+ lásd az Nvidia Xv meghajtó fejezetben.
+
+- más kártyák : a fentiek közül egyik se?
+
+ - Próbáld ki hátha a kártyád, és az XFree86 drivere támogatja a
+ hardveres gyorsítást. Lásd az Xv fejezetet
+ a részletekért.
+ - Ha nem, a kártyád a következő csoportba tartozik :
+
+
+
+
+
+
+YUV gyorsítással nem rendelkező kártyák
+
+
+Ezeknél vagy szoftveresen kell
+nagyítani a képet (ez nagyon lassú), vagy le kell váltani egy kisebb
+videomódba hogy pont akkora legyen a kép (pl 352x288). Ha nincs YUV
+gyorsításod, az utóbbi módszer a célravezetőbb. Az MPlayerben
+ez a -vm
opcióval kapcsolható be. A következő
+meghajtókat érdemes kipróbálni :
+
+ - XFree86 használatával : lásd a
+ DGA és az
+ X11 meghajtók fejezeteit. A DGA
+ használata ajánlott!
+ - XFree86 nélkül : próbáld ki ezeket a meghajtókat, ebben a
+ sorrendben :
+ vesa,
+ fbdev,
+ svgalib,
+ aalib.
+
+
HANGKÁRTYÁK
-- Soundblaster Live : ezekkel a kártyákkal lehetőséged van az
+
+
- Soundblaster Live! : ezzel a kártyával lehetőséged van az
alapértelmezett 2 helyett 4 vagy 6 (5.1) csatornás AC3 kimenetre.
Olvasd el a Szoftveres AC3 dekódolás
fejezetet.
+
+- más kártyák speciális funkcióihoz az MPlayer nem tartalmaz
+ támogatást. Ajánlott a hangkártyák fejezetének
+ elolvasása !
EGYÉB FUNKCIÓK
-- A DVD támogatáshoz le kell fordítanod a libdvdread-et és a libdvdcss-t.
+
- A DVD támogatáshoz le kell fordítanod a libdvdcss-t és a libdvdread-et,
+ méghozzá ilyen sorrendben!
Lásd 4.2-es fejezet.
- Kell grafikus felület? Ha igen, olvasd el az 1.4-es fejezetet
mielőtt még belekezdenél a fordításba.
- Ha fel akar installálni a nagyszerű MEncodert is, nézd meg a
- MEncoder fejezetet is.
+ MEncoder fejezetet is.
- Ha van V4L kompatibilis TV tunered, nézd meg a TV bemenet
fejezetet.
@@ -415,6 +514,10 @@
és a gmplayer
file-t indítsd.
+Mivel a GTK nem fut setuid root binárisból, nem lehet egyszerre
+használni a GUI-t és az új időzítő kódot egyszerre (kivéve persze
+ha root-ként futtatod az MPlayer-t).
+
Mivel az MPlayer alapban nem tartalmaz skineket, ezeket külön kell
letöltened. Lásd itt.
Ezeket a szokásos /usr/local/share/mplayer/Skin
vagy $HOME/.mplayer/Skin
diff -r e1cf5e6338a8 -r c21cea0a12aa DOCS/documentation.html
--- a/DOCS/documentation.html Mon Dec 03 17:06:59 2001 +0000
+++ b/DOCS/documentation.html Mon Dec 03 17:08:09 2001 +0000
@@ -171,19 +171,19 @@
MPlayer is a movie player for LINUX (runs on many other Unices, and
non-x86 CPUs, see section 6). It plays most MPEG, VOB,
-AVI, VIVO, ASF/WMV, QT/MOV files, supported by many native, XAnim, and Win32
-DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx,
-and even DivX movies too (and you don't need the avifile library at
-all!). The another big feature of mplayer is the wide range of supported output
-drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, but you can
-use SDL (and this way all drivers of SDL) and some lowlevel card-specific
-drivers (for Matrox, 3Dfx and Radeon) too! Most of them supports software or
-hardware scaling, so you can enjoy movies in fullscreen. MPlayer
-supports displaying through some hardware MPEG decoder boards, such as the
-DVB and DXR3/Hollywood+ !
-And what about the nice big antialiased shaded subtitles (9 supported
-types!!!) with european/ISO 8859-1,2 (hungarian, english, czech, etc),
-cyrillic, korean fonts, and OSD?
+AVI, VIVO, ASF/WMV, QT/MOV, FLI files, supported by many native, XAnim, and
+Win32 DLL codecs. You can watch VideoCD, SVCD, DVD,
+3ivx, and even DivX movies too (and you don't need the avifile
+library at all!). The another big feature of mplayer is the wide range of
+supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,
+AAlib, DirectFB, but you can use GGI and SDL (and this way all their drivers)
+and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too! Most
+of them supports software or hardware scaling, so you can enjoy movies in
+fullscreen. MPlayer supports displaying through some hardware MPEG
+decoder boards, such as the DVB and DXR3/Hollywood+ ! And what about the nice big antialiased
+shaded subtitles (9 supported types!!!) with european/ISO 8859-1,2
+(hungarian, english, czech, etc), cyrillic, korean fonts, and OSD?
MPlayer is basically GPL, but contains some non-GPL code which is not
allowed to be distributed in binary form, and also contains the OpenDivX
@@ -250,28 +250,44 @@
1.3. Installation
-REQUIREMENTS
+
In this chapter I'll try to guide you through the compiling and
+configuring process of MPlayer. It's not easy, but it won't neccessarily
+be hard. If you experience a different behaviour than what I explain, please
+search through this documentation and you'll find your answers. If you
+see links, please follow them and read carefully what they contain. It
+will take some time, but it DOES worth it.
+
+You need a fairly recent system. On Linux, 2.4.x kernels are required, but
+with 2.4.10 and above you'll ocassionally experience problems (licensing,
+kernel bugs, etc) so they are discouraged.
+
+SOFTWARE REQUIREMENTS
- binutils - suggested version is 2.11.x . This program is
- responsible for generating MMX/3DNow!/etc instructions, thus very important.
+ responsible for generating MMX/3DNow!/etc instructions, thus very important.
- gcc - suggested version is from 2.95.2 to 2.95.4.
- NEVER use 2.96 or 3.x.x !!! They generate faulty code.
- - XFree86 - suggested version is always the newest (4.1.0). Normally
- everyone wants this. If you don't know why, you do need it. Make
- sure its development package is installed too !
+ NEVER use 2.96 or 3.x.x !!! They generate faulty code. If you decide
+ to change gcc from 2.96, then don't decide in favor of 3.0 juts because
+ it's newer! In some ways it's even worse than 2.96. So downgrade to
+ 2.95.x (downgrade libstdc++ too!) or don't up/downgrade at all (but in
+ this case, be prepared for runtime problems).
+ Detailed information about gcc 2.96's bugs can be found
+ here and in the
+ FAQ !
+ - XFree86 - suggested version is always the newest (4.1.0).
+ Normally everyone wants this, as starting from XFree86 4.0.2, it contains
+ the XVideo extension (somewhere referred
+ as Xv) which is needed to enable the hardware YUV acceleration (fast
+ image display) on cards that support it. More
+ information available.
+ Make sure its development package is installed too otherwise
+ it won't work.
+ For some videocards you don't need XFree86. See list below.
- make - suggested version is always the newest (at least 3.79.x). This
- usually isn't important.
+ usually isn't important.
- SDL - it's not mandatory, but can help in some cases. Always
- use the newest (beginning from 1.2.x).
-
-
-
-Read the following before trying to compile MPlayer:
-
-
-- If you have gcc 2.96 on your system, READ
-THIS and the FAQ !
+ use the newest (beginning from 1.2.x).
CODECS
@@ -282,7 +298,7 @@
- you can gain DivX/DivX4 playing on non-x86 machines
- this codec has the greatest decoding speed for DivX and DivX4
-movies (even faster than the original DivX4 library itself) !
+movies (even faster than the original DivX4 library itself) ! Recommended!
@@ -303,7 +319,8 @@
MEncoder, you possibly don't want this codec as libavcodec (see
above) is much faster than this.
Features :
- - can play old DivX3 movies much faster than the Win32 DLL
+ - can play old DivX3 movies much faster than the Win32 DLL but
+ slower than libavcodec !
- it's closed-source, and only an x86 version is available.
- You also need this codec for MEncoder, see below !
@@ -311,10 +328,28 @@
If you want to play 3ivx movies, check the
XAnim codecs section.
+
+The XAnim codecs are the best (full screen,
+hardware YUV zoom) for decoding old videos like Indeo 3/4/5, Cinepak, and some
+others. And they are multiplatform, so this is the only way to play Indeo on
+non-x86 platforms (well, apart from using XAnim:).
+
VIDEOCARDS
+There are generally two kind of videocards. One kind (the newer cards) has
+hardware YUV acceleration support, the other cards don't.
+
+
+YUV cards
+
+
+They can display and scale (zoom) the picture to any size that fits in
+their memory, with small CPU usage (zooming doesn't increase it!), thus
+you get a nice and very fast fullscreen playing.
+
+
- Matrox G200/G400/G450/G550 cards : please see the mga_vid
section in order to gain big speedup. It is important to do these steps
@@ -333,20 +368,73 @@
supported under Linux/MPlayer. If you have a Radeon or Rage128 card, we have a
XXX_vid driver for you, with TV out ! Check this section !
+
+- S3 cards : the Savage chips have hardware acceleration. Use as
+new XFree86 version as possible, older drivers are buggy. Savage chips
+have problems with YV12 display, see S3 Xv
+section for details. Older, non-Savage cards have no, or slow hardware
+support.
+
+- Nvidia cards : very bad choice for video playing. Nvidia's
+cards are manufactured on the far-east, and have very cheap and bad
+quality chips. Moreover, the built-in Nvidia driver in XFree86 doesn't
+contain support for hardware YUV acceleration! You have to download
+Nvidia's closed-source drivers from nvidia.com . See details in Nvidia Xv driver section.
+
+- other cards : none of the above?
+
+ - Try if the XFree86 driver (and your card) supports hardware
+ acceleration. See the Xv section for
+ details.
+ - If it doesn't, your card is one of the :
+
+
+
+
+
+
+Non-YUV cards
+
+
+Fullscreen playing can be achieved by either zooming
+(by software, this is slooow), or changing to a smaller videomode, for
+example to 352x288. If you don't have YUV accel, this latter method is
+the recommended one. Throughout MPlayer, this behaviour can
+be switched on by using the -vm
option and with
+the following drivers :
+
+
SOUNDCARDS
+
- Soundblaster Live! : with this card you can use 4 or 6 (5.1)
channels AC3 decoding instead of 2. Read the
Software AC3 decoding section.
+
+- other cards' features aren't supported by MPlayer.
+ It's very recommended to read the soundcards
+ section !
FEATURES
-- For DVD support, you'll have to compile libdvdread and libdvdcss.
+
- For DVD support, you'll have to compile libdvdcss and libdvdread, and
+in this order!
See section 4.2 for more information.
- Decide if you need GUI. If you do, see the 1.4 section
@@ -410,6 +498,10 @@
+Since GTK doesn't run from a setuid root binary, you can't use
+the GUI and the new timer code (mentioned above) together (unless
+you run MPlayer as root, of course).
+
As MPlayer doesn't have a skin included, you have to download them
if you want to use the GUI. See the download page.
They should be extracted to the usual system-wide directory (/usr/local/share/mplayer/Skin
),