summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorgabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-08-21 20:59:23 +0000
committergabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-08-21 20:59:23 +0000
commit1af8d58c0bf4a4cbac5fa9e5cfb8bc382c047b8c (patch)
tree6e96fc97c24259d0c5e1e8714241565cbfcda66d /DOCS
parentb5532f2ec3a4d8bd41793a7d02efdd6ecdc9d9ac (diff)
downloadmpv-1af8d58c0bf4a4cbac5fa9e5cfb8bc382c047b8c.tar.bz2
mpv-1af8d58c0bf4a4cbac5fa9e5cfb8bc382c047b8c.tar.xz
they've been moved to html
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@1612 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/AUTHORS183
-rw-r--r--DOCS/BUGREPORTS128
-rw-r--r--DOCS/CDROM44
-rw-r--r--DOCS/CODECS66
-rw-r--r--DOCS/DEBIAN19
-rw-r--r--DOCS/DGA198
-rw-r--r--DOCS/DVD139
-rw-r--r--DOCS/DVD-FAQ41
-rw-r--r--DOCS/DivX4Linux40
-rw-r--r--DOCS/FREEBSD22
-rw-r--r--DOCS/INSTALL43
-rw-r--r--DOCS/LIRC60
-rw-r--r--DOCS/MPlayer-FAQ268
-rw-r--r--DOCS/MTRR39
-rw-r--r--DOCS/OpenDivX37
-rw-r--r--DOCS/README308
-rw-r--r--DOCS/SDL24
-rw-r--r--DOCS/SOLARIS81
-rw-r--r--DOCS/SOUNDCARDS61
-rw-r--r--DOCS/SPEED42
-rw-r--r--DOCS/TODO54
-rw-r--r--DOCS/TVout-G40067
-rw-r--r--DOCS/VIDEOCARDS199
-rw-r--r--DOCS/documentation.html2312
24 files changed, 0 insertions, 4475 deletions
diff --git a/DOCS/AUTHORS b/DOCS/AUTHORS
deleted file mode 100644
index f8b82f8190..0000000000
--- a/DOCS/AUTHORS
+++ /dev/null
@@ -1,183 +0,0 @@
- AUTHORS:
- ~~~~~~~~
-
-NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors!
-===== Read DOCS/BUGREPORTS and subscribe to mplayer-users mailing lists.
- Patches & devel stuff should be sent to the mplayer-dev-eng mailing list.
-
-========================== The MPlayer project: ===============================
-
-Árpád Gereöffy (A'rpi/ESP-team): <arpi@thot.banki.hu>
-- player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)
-- mp3lib, based on mpglib sources [MP3 audio decoder]
-- getch2 [keyboard handler]
-- some changes in libmpeg2 code (progressive frames, bitrate & fps support)
-- libvo improvements: adding OpenGL support, bugfix in mga driver...
-- triple buffering & YUY2 support (for DivX/MPEG4) into mga_vid driver
-- scripts in the TVout directory (TVout on Matrox G400DH, read DOCS/TVout-G400)
-- hacking DivX/Mpeg4 VfW codecs to get YUV output
-- opendivx decoder speed optimizations (see opendivx/ChangeLog)
-- OSD & SUB display code
-
-Zoltán Ponekker (Pontscho/Fresh!): <pontscho@makacs.poliod.hu>
-- configure script and Makefiles for easy compile
-- GUI system (near complete!?)
-- 3DNow! support into mp3lib
-- 3DNow! support into fastmemcpy.h
-- various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)
-- libvo: adding xmga driver, and fullscreen support to xv
-- audio mixer (volume) support
-
-Gábor Lénárt (LGB): <lgb@lgb.hu>
-- ./configure script improvements
-- Makefile improvements
-- prelimenary DVD support
-- another GUI code (is that so..?)
-- various X11 cleanups and fixes
-
-Gábor Bérczi (Gabucino): <gabucino@k2.jozsef.kando.hu>
-- documentation maintainer
-- hungarian translation of documentation
-- second webpage design&gfx
-- webpage maintainer
-- testing, codecs quality & speed comparsions
-- IRC channel #MPlayer operator
-- experimental MINIX port :)
-
-Szabolcs Berecz (Szabi): <szabi@inf.elte.hu>
-- codecs.conf file parser
-- config file and command line parser
-- mga_vid fixes, module option etc.
-- fbdev support in libvo
-- type #7 subtitle support
-
-László Megyer (Lez, Laaz): <lez@sch.bme.hu>
-- SUB reader
-- screensaver+DPMS disable for libvo
-
-Gyula László (Chass, Tégla): <chass-@freemail.hu>
-- first fonts (mp_font1.zip)
-- third (current) homepage design&gfx
-
-Zoltán Márk Vicián (Se7en): <se7en@sch.bme.hu>
-- SVGAlib support in libvo
-
-Alex Beregszaszi (Al3x): <alex@naxine.org>
-- ALSA output driver in libao2
-- vo_ggi output driver in libvo (www.ggi-project.org)
-
-Andreas Ackermann (Acki): <asackerm@stud.informatik.uni-erlangen.de>
-- LIRC support (see DOCS/LIRC)
-- DGA support in libvo
-
-Felix Bünemann (Atmos): <atmosfear@users.sourceforge.net>
-- SDL driver maintainer
-- Additional YUV formats fixes
-- New font (mp_font2.zip)
-- PNG file output support in libvo
-- flipping support (for Indeo 3/4, etc)
-- SDL audio driver in libao2
-- RAW PCM/WAVE file writer for libao2
-
-TeLeNiEkO: <telenieko@telenieko.com>
-- spanish translation of documentation
-
-Michael Graffam: <mgraffam@idsi.net>
-- XF86VidMode support to vo_x11 and vo_dga
-- Video mode switching code to vo_dga
-
-Jens Hoffmann: <hoffmajs@gmx.de>
-- Additional YUV formats support
-- found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization
-
-Nick Kurshev: <nickols_k@mail.ru>
-- memcpy optimizations for AMD K7 and Intel Pentium III (fastmemcpy.h)
-- CDROM tune info
-- further 3DNow! optimizations into mp3lib, libac3 and ffmpeg
-- russian translation of documentation
-
-German Gomez Garcia: <german@piraos.com>
-- SPDIF AC3 output for SBLive!
-
-Dariush Pietrzak (Eyck): <eyck@incubus.ar.lublin.pl>
-- debian packaging support (see debian/* and DOCS/DEBIAN)
-- support for vplayer subtitle format
-- prelimenary support for .RT subtitle format
-
-Marcus Comstedt: <marcus@idonex.se>
-- initial solaris8-x86 support
-
-Jürgen Keil and Marcus Comstedt: <jk@tools.de> <marcus@idonex.se>
-- patched MPlayer to work on Solaris 8 x86
-- various fixes (win32, configure, etc)
-- SUN audio driver in libao2
-
-Vladimir Kushnir: <vkushnir@Alfacom.net>
-- patched MPlayer to work on FreeBSD x86
-
-Bertrand BAUDET: <bertrand_baudet@yahoo.com>
-- network streaming support
-
-Artur Zaprzala: <artur.zaprzala@talex.com.pl>
-- Complete font generator prog + OSD font (TOOLS/subfont-c)
-
-lanzz@lanzz.org:
-- GIMP font generator plugin (TOOLS/subfont-gimp)
-
-Adam Tla/lka: <atlka@pg.gda.pl>
-- osd/sub review, fixes, optimization, utf8 support
-- various fixes
-
-Folke Ashberg: <folke@ashberg.de>
-- AAlib driver for libvo (vo_aa)
-
-Main testers:
- Tibor Balázs (Tibcu)
- Péter Sasi (SaPe)
- Christoph H. Lampert
- Attila Kinali
- Dirk Vornheder
-
-========================== The codecs, libs: =================================
-
-Aaron Holtzman: <aholtzma@engr.uvic.ca>
-- ac3dec (and libac3) author [AC3 audio decoder]
-- mga_vid driver [Matrox G200/G400 YUV Back-end Scaler]
-- mpeg2dec [Fast MPEG1/MPEG2 video decoder, currently used in player]
-
-Michel Lespinasse: <walken@zoy.org>
-- did large libmpeg2 changes for better speed and mpeg conformance
-
-Eugene Kuznetsov: <divx@euro.ru>
-- avifile author [AVI player library for linux, using Win32 VfW/ACM codecs]
-- technical help about AVI and ASF formats, and how to get YUV using VfW...
-- divx4linux techical support
-
-Zdenek Kabelac: <kabi@informatics.muni.cz>
-- current avifile maintainer(?)
-- some technical help about the win32 stuff and timers
-
-Gerard Lantau: <glantau@yahoo.fr>
-- ffmpeg/libavcodec author,maintainer (opensource mpeg, mjpeg & divx codecs)
-
-Project Mayo: [http://www.projectmayo.com]
-- the OpenDivX codec authors
-
-Michael Hipp:
-- mpglib author [isn't used directly but some parts in mp3lib]
-
-Mark Podlipec:
-- xa_gsm.c author [MS-GSM audio codec]
- [from a GSM library by Jutta Degener and Carsten Bormann]
-
-Their code is not used in current player version, but I've got some ideas or
-other technical help from:
-
-John F. McGowan http://www.jmcgowan.com/
-- AVI FAQ author/collector. [site with many useful docs on codecs and avi fmt]
-
-Dirk Farin: <farin@ti.uni-mannheim.de>
-- dvdview author [MPEG1/MPEG2 video decoder, used in v0.5-v0.8]
-
-Adam Williams: <broadcast@earthling.net>
-- libmpeg3 (and xmovie) author [MPEG1/MPEG2 video decoder, used in v0.1-v0.4]
diff --git a/DOCS/BUGREPORTS b/DOCS/BUGREPORTS
deleted file mode 100644
index 0a85aca614..0000000000
--- a/DOCS/BUGREPORTS
+++ /dev/null
@@ -1,128 +0,0 @@
-How to report bugs?
-~~~~~~~~~~~~~~~~~~~
-First read DOCS/BUGS, and other docs. If your problem isn't
-known or isn't solved by our instructions, then report the bug:
-
-Where?
-======
-Subscribe to the mplayer-users mailing list:
- http://lists.sourceforge.net/lists/listinfo/mplayer-users
-and send your bugreport to:
- mplayer-users@lists.sourceforge.net
-We won't CC: so please subscribe!!!
-
-Don't send bugreports private, directly to author's address!!!
-We are working together on code, so everyone is interested in it.
-BTW many times other users know the solution (system config probs,
-bad drivers etc), even when we think it's a bug in our code.
-The language of this list is ENGLISH !
-
-Please describe your problem in details, examples etc, and don't
-forget to include these:
-
-What?
-=====
-
-1. The system info what we always want:
-- linux distribution
- examples:
- RedHat 7.1
- Slackware 7.0 + devel packs from 7.1 ...
-- kernel version:
- uname -a
-- libc version:
- ls -l /lib/libc[.-]*
-- X version:
- X -version
-- gcc and ld version:
- gcc -v
- ld -v
-- binutils version:
- as --version
-
-2. Hardware & drivers:
-- CPU info:
- cat /proc/cpuinfo
-- video card manufacturer and model
- examples:
- ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM
- Matrox G400 DH 32MB SGRAM
-- video driver type&version
- examples:
- X built-in driver
- nvidia 0.9.623
- Utah-GLX CVS 2001-02-17
- DRI from X 4.0.3
-- sound card type & driver
- examples:
- Creative SBLive! Gold with OSS driver from oss.creative.com
- Creative SB16 with OSS drivers of kernel
- GUS PnP with ALSA OSS emulation
-- if you are unsure, attach output of lspci -v
-
-For compiling problems/errors:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-3. output of configure/make:
- make distclean
- ./configure &>config.log
- ./make &>make.log
-4. these files:
- config.h
- config.mak
- libvo/config.mak
-
-For playback problems:
-~~~~~~~~~~~~~~~~~~~~~~
-3. Output of mplayer at verbose level 1 (-v)
- mplayer -v [options] filename &> mplayer.log
-
-4. If the problem is specific to one or a few files,
- then please upload that file to:
- ftp://thot.banki.hu/MPlayer/incoming/
- Usually first 1-5 MB of the file is enough to reproduce
- the problem, but first you should try it:
- dd if=yourfile of=smallfile bs=1k count=1024
- (it will cut first 1MB of 'yourfile' and save to 'smallfile')
- Then try again on this small file, and if bug still exists
- then it's enough to upload this small file.
- NEVER send such files via mail! Upload it, and send only
- the path/filename of the file on the FTP.
- If the file is accessible on the net, then sending the
- _exact_ URL is enough!
-
-5. For crashes (segfault, SIGILL, signal 4 etc):
-
-If you have coredump of the crash, see 5.a, else see 5.b:
-
-5.a: Please print us coredump (if it was created).
-Howto:
-please create following command file:
-
-disass $eip-32 $eip+32
-printf "eax=%08lX\n",$eax
-printf "ebx=%08lX\n",$ebx
-printf "ecx=%08lX\n",$ecx
-printf "edx=%08lX\n",$edx
-printf "esp=%08lX\n",$esp
-printf "ebp=%08lX\n",$ebp
-printf "edi=%08lX\n",$edi
-printf "esi=%08lX\n",$esi
-
-Then simply execute following command line:
-gdb mplayer --core=core -batch --command=command_file >mplayer.bug
-
-5.b.: run MPlayer in gdb:
-[at root/user shell prompt:]
- # gdb mplayer
-[at gdb prompt:]
- > run -v [options-to-mplayer] filename
- ... (wait until it will crash)
- > bt
- > disass $eip-32 $eip+32
-Send us the full output of the above things!
-
-In general:
-~~~~~~~~~~~
- If something is big (logs etc) then it's better to upload to the ftp
- (gzipped), and include only path/filename in the bugreport!
-
diff --git a/DOCS/CDROM b/DOCS/CDROM
deleted file mode 100644
index 0b8f81e6e2..0000000000
--- a/DOCS/CDROM
+++ /dev/null
@@ -1,44 +0,0 @@
-
-Tune up CDROM
-~~~~~~~~~~~~~
-
-Introduction
-~~~~~~~~~~~~
->From Linux documentation:
-
-Some CDROM drives are capable of changing their head-speed. There are several
-reasons for changing the speed of a CDROM drive. Badly pressed CDROMs may
-benefit from less-than-maximum head rate. Modern CDROM drives can obtain very
-high head rates (up to 24-times is common). It has been reported that these
-drives can make reading errors at these high speeds, reducing the speed can
-prevent data loss in these circumstances. Finally, some of these drives can
-make an annoyingly loud noise, which a lower speed may reduce.
-
-Howto
-~~~~~
-The recommended way to do it is with a program called 'setcd' . It's kinda
-old, but won't be too hard to find on the Net.
-Use it with :
- setcd -x <speed> <cdrom device>
-
-Also you can try :
- echo current_speed:4 >/proc/ide/<cdrom device>/settings
-but you'll need root privileges. (It didn't work for me - Gabucino)
-
-I use following command too :
- echo file_readahead:2000000 >/proc/ide/<cdrom device>/settings
-for 2MB prefetched reading from the file (it's useful for scratched CDROMs).
-
-It's recommended that you tuneup your CDROM drive also with hdparm :
- hdparm -d1 -a8 -u1 <cdrom device>
-to enable using DMA access, readahead, and IRQ unmasking.
-(if you don't understand these, *read the hdparm manpage*)
-
-Final words
-~~~~~~~~~~~
-Please refer to "/proc/ide/<cdrom device>/settings" for fine-tuning your CDROM.
-
- Nick Kurshev & Gabucino
- <nickols_k@mail.ru>
-
-
diff --git a/DOCS/CODECS b/DOCS/CODECS
deleted file mode 100644
index 6f589fe7de..0000000000
--- a/DOCS/CODECS
+++ /dev/null
@@ -1,66 +0,0 @@
-
-Status of codecs support:
-=========================
-
-See http://mplayer.sourceforge.net/DOCS/codecs.html
-
-If your codecs isn't listed there then help us adding support for it:
-
-Extracting codecs from Win32
-============================
-
-1. VfW
-~~~~~~
- VfW (Video for Windows) is the old Video API for Windows. Its codecs have
-the .DLL or (rarely) .DRV extension.
-If MPlayer fails with your AVI:
-
- UNKNOWN video codec: HFYU (0x55594648)
-
- It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU =
-HuffYUV codec, DIV3 = DivX Low Motion, etc...). Now that we know this, we'll
-have to find out which DLL Windows loads in order to play this file. In our
-case, the system.ini contains this (with many others):
- VIDC.HFYU=huffyuv.dll
-So we'll need the huffyuv.dll file. Note that the audio codecs are specified
-with the MSACM prefix :
- msacm.l3acm=L3codeca.acm
-This is the MP3 codec.
-
-So, now we have all the info needed (fourcc, codec file, sample AVI), submit
-your codec support request in mail, and upload these files to the FTP:
- ftp://thot.banki.hu/MPlayer/incoming/<codecname>/
-
-
-2. DirectShow
-~~~~~~~~~~~~~
- DirectShow is the newer Video API, which is even worse than its predecessor.
-Things are harder with DirectShow, since
- - system.ini doesn't contain the needed information, instead it's stored in
- the registry :(
- - we'll need the GUID of the codec.
-
- So let's search that goddamn registry..
- - Start 'regedit'
- - press ctrl-f, disable the first two checkbox, and enable the third. Type
-the fourcc of the codec. (for ex.: TM20)
- - you should see a field which contains the path and filename
- (for ex. : C:\WINDOWS\SYSTEM\TM20DEC.AX)
- - now that we have the file, we'll need the GUID. Try searching again, but
-now we'll search for the codec's name, not the fourcc. Its name can be acquired
-when Media Player is playing that file, by checking File/Properties/Advanced.
-If not, bad luck ;) Try guessing.
- (for ex. search for : TrueMotion)
- - if found (in registry), there should be a FriendlyName field, and a CLSID
-field. Write down that 16 byte of CLSID, this is the GUID required by us.
-
-NOTE : if searching fails, try to enable all the checkboxes.. you may have
- false hits, but maybe you'll have the right, too...
-NOTE : dump that M$ shit.
-
-So, now we have all the info needed (fourcc, GUID, codec file, sample AVI),
-submit your codec support request in mail, and upload these files to the FTP:
- ftp://thot.banki.hu/MPlayer/incoming/<codecname>/
-
-
- Gabucino & A'rpi
diff --git a/DOCS/DEBIAN b/DOCS/DEBIAN
deleted file mode 100644
index 9c16bee957..0000000000
--- a/DOCS/DEBIAN
+++ /dev/null
@@ -1,19 +0,0 @@
-To build the package:
- Get the cvs version, or .tgz and uncompress it,
- cd into programs directory:
-eyck@incubus:~/src$ cd main
-eyck@incubus:~/src/main$ fakeroot debian/rules binary
- (... mplayer detects hardware/software, builds itself and.. )
- ..
- dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.
-
-And now just dpkg -i ../mplayer_0.18-1_i386.deb as root.
-Here's how it looks like:
-
-eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb
-Password:
-(Reading database ... 26946 files and directories currently installed.)
-Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb) ...
-Unpacking replacement mplayer ...
-Setting up mplayer (0.18-1) ...
-
diff --git a/DOCS/DGA b/DOCS/DGA
deleted file mode 100644
index eb4a966a6c..0000000000
--- a/DOCS/DGA
+++ /dev/null
@@ -1,198 +0,0 @@
-
-Contents
-~~~~~~~~
-
- 1. Summary
- 2. What is DGA
- 3. Resolution switching
- 4. DGA & MPlayer
- 5. Features of the DGA driver
- 6. Speed issues
- 7. Known bugs
- 8. Future work
-
- A. Some modelines
- B. Bug Reports
-
-
-1. Summary
-~~~~~~~~~~
- This document tries to explain in some words what DGA is in general and
- what the DGA video output driver for mplayer can do (and what it can't).
-
-2. What is DGA?
-~~~~~~~~~~~~~~~
-
- DGA is short for Direct Graphics Access and is a means for a program to
- bypass the X-Server and directly modifying the framebuffer memory.
- Technically spoken this happens by mapping the framebuffer memory into
- the memory range of your process. This is allowed by the kernel only
- if you have superuser privileges. You can get these either by logging in
- as root or by setting the suid bit on the mplayer excecutable (NOT
- recommended!).
-
- There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was
- introduced with XFree 4.0.1.
-
- DGA1 provides only direct framebuffer access as described above. For
- switching the resolution of the video signal you have to rely on the
- XVidMode extension.
-
- DGA2 incorporates the features of XVidMode extension and also allows
- switching the depth of the display. So you may, although basically
- running a 32 bit depth XServer, switch to a depth of 15 bits and vice
- versa.
-
- However DGA has some drawbacks. It seems it is somewhat dependent on the
- graphics chip you use and on the implementation of the XServer's video
- driver that controls this chip. So it does not work on every system ...
-
-
-3. Resolution switching
-~~~~~~~~~~~~~~~~~~~~~~~
- The DGA driver allows for switching the resolution of the output signal.
- This avoids the need for doing (slow) software scaling and at the same
- time provides a fullscreen image. Ideally it would switch to the exact
- resolution (except for honouring aspect ratio) of the video data, but the
- XServer only allows switching to resolutions predefined in
- /etc/X11/XF86Config (/etc/X11/XF86Config-4 for XFree 4.0.X respectively).
- Those are defined by so-called modelines and depend on the capabilites
- of your video hardware. The XServer scans this config file on startup and
- disables the modelines not suitable for your hardware. You can find
- out which modes survive with the X11 log file. It can be found at:
- /var/log/XFree86.0.log
- See appendix A for some sample modeline definitions.
-
-4. DGA & MPlayer
-~~~~~~~~~~~~~~~~
-
- DGA is used in two places with MPlayer: The SDL driver can be made to make
- use of it (-vo sdl:dga) and within the DGA driver (-vo dga).
- The above said is true for both; in the following sections I'll explain
- how the DGA driver for MPlayer works.
-
-
-5. Features of the DGA driver
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
- The DGA driver is invoked by specifying -vo dga at the command line.
- The default behaviour is to switch to a resolution matching the original
- resolution of the video as close as possible. It deliberately ignores the
- -vm and -fs switches (enabling of video mode switching and fullscreen) -
- it always tries to cover as much area of your screen as possible by switching
- the video mode, thus refraining to use a single additional cycle of your CPU
- to scale the image.
- If you don't like the mode it chooses you may force it to choose the mode
- matching closest the resolution you specify by -x and -y.
- By providing the -v option, the DGA driver will print, among a lot of other
- things, a list of all resolutions supported by your current XF86-Config
- file.
- Having DGA2 you may also force it to use a certain depth by using the -bpp
- option. Valid depths are 15, 16, 24 and 32. It depends on your hardware
- whether these depths are natively supported or if a (possibly slow)
- conversion has to be done.
-
- If you should be lucky enough to have enough offscreen memory left to
- put a whole image there, the DGA driver will use doublebuffering, which
- results in much smoother movie replaying. It will tell you whether double-
- buffering is enabled or not.
-
- Doublebuffering means that the next frame of your video is being drawn in
- some offscreen memory while the current frame is being displayed. When the
- next frame is ready, the graphics chip is just told the location in memory
- of the new frame and simply fetches the data to be displayed from there.
- In the meantime the other buffer in memory will be filled again with new
- video data.
-
- Doublebuffering may be switched on by using the option -double and may be
- disabled with -nodouble. Current default option is to disable
- doublebuffering. When using the DGA driver, onscreen display (OSD) only
- works with doublebuffering enabled. However, enabling doublebuffering may
- result in a big speed penalty (on my K6-II+ 525 it used an additional 20% of
- CPU time!) depending on the implementation of DGA for your hardware.
-
-
-
-6. Speed issues
-~~~~~~~~~~~~~~~
- Generally spoken, DGA framebuffer access should be at least as fast as using
- the X11 driver with the additional benefit of getting a fullscreen image.
- The percentage speed values printed by mplayer have to be interpreted with
- some care, as for example, with the X11 driver they do not include the time
- used by the X-Server needed for the actual drawing. Hook a terminal to a
- serial line of your box and start top to see what is really going on in your
- box ...
-
- Generally spoken, the speedup done by using DGA against 'normal' use of X11
- highly depends on your graphics card and how well the X-Server module for it
- is optimized.
-
- If you have a slow system, better use 15 or 16bit depth since they require
- only half the memory bandwidth of a 32 bit display.
-
- Using a depth of 24bit is even a good idea if your card natively just supports
- 32 bit depth since it transfers 25% less data compared to the 32/32 mode.
-
- I've seen some avi files already be replayed on a Pentium MMX 266. AMD K6-2
- CPUs might work at 400 MHZ and above.
-
-7. Known Bugs
-~~~~~~~~~~~~~
-
- Well, according to some developpers of XFree, DGA is quite a beast. They
- tell you better not to use it. Its implementation is not always flawless
- with every chipset driver for XFree out there.
-
- o with XFree 4.0.3 and nv.o there is a bug resulting in strange colors
- o ATI driver requires to switch mode back more than once after finishing
- using of DGA
- o some drivers simply fail to switch back to normal resolution (use
- Ctrl-Alt-Keypad +, - to switch back manually)
- o some drivers simply display strange colors
- o some drivers lie about the amount of memory they map into the process's
- address space, thus vo_dga won't use doublebuffering (SIS?)
- o some drivers seem to fail to report even a single valid mode. In this
- case the DGA driver will crash telling you about a nonsense mode of
- 100000x100000 or the like ...
- o OSD only works with doublebuffering enabled
-
-8. Future work
-~~~~~~~~~~~~~~
-
- o use of the new X11 render interface for OSD
- o where is my TODO list ???? :-(((
-
-
-A. Sample modelines
-~~~~~~~~~~~~~~~~~~~
-Section "Modes"
- Identifier "Modes[0]"
- # 800x600 @ 60 Hz, 37.8 kHz hsync
- Modeline "800x600" 40 800 840 968 1056 600 601 605 628
- Modeline "712x600" 35.0 712 740 850 900 400 410 412 425
- Modeline "640x480" 25.175 640 664 760 800 480 491 493 525
- Modeline "400x300" 20 400 416 480 528 300 301 303 314 Doublescan
- Modeline "352x288" 25.10 352 368 416 432 288 296 290 310
- Modeline "352x240" 15.750 352 368 416 432 240 244 246 262 Doublescan
- Modeline "320x240" 12.588 320 336 384 400 240 245 246 262 Doublescan
-EndSection
-
-
- These entries work fine with my Riva128 chip, using nv.o XServer driver
- module.
-
-B. Bug Reports
-~~~~~~~~~~~~~~
-
- If you experience troubles with the DGA driver please feel free to file
- a bug report to me (e-mail address below). Please start mplayer with the
- -v option and include all lines in the bug report that start with vo_dga:
-
- Please do also include the version of X11 you are using, the graphics card
- and your CPU type. The X11 driver module (defined in XF86-Config) might
- also help. Thanks!
-
-
- Acki (acki@acki-netz.de, www.acki-netz.de) 18.06.2001
-
-
diff --git a/DOCS/DVD b/DOCS/DVD
deleted file mode 100644
index cd78b39f9f..0000000000
--- a/DOCS/DVD
+++ /dev/null
@@ -1,139 +0,0 @@
-DVD support in MPlayer!
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Read file 'DVD-FAQ' as well (and try to avoid recursion by the redirector
-message there :).
-
-IMPORTANT NOTE: please _DO_NOT_ require further features for DVD playback. This
-is extremly experimental hack. Maybe it won't work for you. If you're
-capable of helping us do it now! First we would like to fix existing problems.
-Then we can start implementing advanced DVD playback functions of course.
-
-This means current DVD functions are mainly for developers and not for users!
-
-Building MPlayer with libcss support
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-First, you must compile and install libcss on your system.
-Second, you have to recompile MPlayer with libcss support. There is
-autodetection of libcss, but if it fails, see below :
-
-Call ./configure script of MPlayer with these options:
-
-./configure --enable-css --with-csslibdir=/usr/local/lib --with-cssincdir=/usr/local/include
-
-(of course you can append your favourite options as well)
-
---with-csslibdir=/usr/local/lib
- Directory contains libcss.so shared library. This directory should
- be in your /etc/ld.so.conf as well.
-
---with-cssincdir=/usr/local/include
- Directory contains header file 'css.h' of libcss.
-
-Viewing VOB files directly from DVD
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-mplayer -dvdauth /dev/dvd /mnt/cdrom/video_ts/vts_01_1.vob
-
-where,
-
- '-dvdauth /dev/dvd' tells MPlayer the device name of your DVD drive.
- it's used in disc authentication process
-
- the filename is simply a VOB file path on the disc
-
-Note that according to my experiences, disc authentication requires root
-privileges so you must run MPlayer as root! (see section 'Problems').
-
-NOTE about the sound:
- It seems that MPlayer sometimes fails to find the first audio stream.
- You can specify it with the '-aid 128' option, for example.
- Please experience with 128,129 and similar values. See section
- 'Problems'.
-
-
-New source files
-~~~~~~~~~~~~~~~~
-dvdauth.c
- Issues DVD disc and title authentication and fills key_disc and
- key_title arraies.
-
-dvdauth.h
- header file
-
-These files are embedded inside an '#ifdef ... #endif' block, so if libcss
-support was not requested, they do not produce any code and of course
-libcss is not linked against MPlayer either.
-
-
-Modifications in the source
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-* (stream.c) STREAM_BUFFER_SIZE is set to 2048
-* (demux_mpg.c) the old message of 'encrypted VOB file is not supported'
- was changed to set a flag to 1. After parsing the header, if this
- flag is set, we call descramble function of libcss for decrypt.
-* (stream.c) on several points where the old 4096 length STREAM_BUFFER_SIZE was
- hardcoded into the source, it was replaced with 'STREAM_BUFFER_SIZE'
-* (mplayer.c) calling dvd disc and title authentication and seek to sector
- boundaries on seeking for mpegs
-
-
-Performance
-~~~~~~~~~~~
-On my AMD K6-2 with using hw scaling and colorspace conversion
-capability of my G400 it's possible to watch DVD with about 70%
-CPU usage with '-nosound'. Unfortunately with sound my machine is
-not enough :( Maybe it can be improved somewhat ...
-Guess, it's not so bad ... According to reports from my friends
-xine uses 80-90% CPU to play DVD on much more powerful machines
-like 1GHz Athlon systems (as far as I know, it's said that about
-300MHz celeron is the minimum to watch DVDs ... using windows
-DVD viewers).
-
-Hint: I commented out downmix functions from libac3 (of course in this way I
-can't get sound) and audio decoding CPU usage became 11% instead of 24 on
-my machine. This clearly indicates that we should optimize downmix functions
-(KNI code is no use for my k6-2).
-
-HOT NEWZ:
-We have got 3Dnow optimized libac3. Wow ;-)
-
-
-Problems (TODO)
-~~~~~~~~~~~~~~~
-* disc authentication (the FIBMAP ioctl) requires root privilegies.
- this is strange since OMS can do it as user too.
-* sound. I'm using my only DVD disc (The Matrix) to test MPlayer.
- some VOB file have English sound, some have Spanish and some have
- no sound at all.
- IT SEEMS that if I give '-aid 128' everything works with English sound ...
-* strange effects but only with SOME vob files (it looks like some interlacing
- effect, eg: every 2nd line on the screen is from the last frame).
-
-
-feature TODO
-~~~~~~~~~~~~
-* chapter scanner
-* audio stream scanner and allow to select one on runtime as well
- (in stage#1 it would be enough to select one on the startup, see
- 'Problems' above)
-* DVD menu
- I found (at least on disc 'The Matrix') the menu VOB but I don't
- know how can it be used.
- (after some eyeballing on the source of OMS, it seems we would have to
- parse *.ifo files)
-* subtitle support
-* OSD/GUI (?) support for select chapter, subtitle and audio stream
-* getting some documentation on DVD format, eg: which is the 'root' VOB
- file on the disc in video_ts directory, which is the menu and so on.
-* improve performance (see 'Performance' above)
-
-
-No sound problem (from Matrix DVD, the menu VOB)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-End of packet while searching for PC