RepoMirrors/mpv
1
0
Fork 0
mirror of https://github.com/mpv-player/mpv synced 2025-01-02 04:42:10 +00:00
Code Issues Releases Wiki Activity

big review ! (translators curse me:)

Browse Source 
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@750 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
gabucino 2001-05-10 09:48:03 +00:00
parent dcbbd60bc2
commit 84b1122dd2
7 changed files with 61 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
DOCS/AUTHORS
View File

@ -18,7 +18,7 @@
Zoltán Ponekker (Pontscho/Fresh!): <pontscho@makacs.poliod.hu>
- configure script and Makefiles for easy compile
- GUI system (/still/ coming soon!)
- GUI system (near complete!?)
- 3DNow! support into mp3lib
- 3DNow! support into fastmemcpy.h
- various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)
@ -29,11 +29,11 @@ G
- ./configure script improvements
- Makefile improvements
- prelimenary DVD support
- another GUI code (coming soon or later :)
- another GUI code (is that so..?)
Gábor Bérczi (Gabucino): <gabucino@k2.jozsef.kando.hu>
- documentation maintainer, hun-eng translator
- webpage maintaining
- webpage maintainer
- testing, codecs quality & speed comparsions
- IRC channel #MPlayer operator
@ -52,12 +52,13 @@ Gyula L
Zoltán Márk Vicián (Se7en): <se7en@sch.bme.hu>
- SVGAlib support in libvo
- native AAlib driver (coming soon)
Andreas Ackermann: <asackerm@stud.informatik.uni-erlangen.de>
- LIRC support (see DOCS/LIRC)
- DGA support in libvo
Felix Bünemann: <Felix.Buenemann@gmx.de>
Felix Bünemann: <atmosfear@users.sourceforge.net>
- SDL driver maintainer
- Additional YUV formats fixes
- New font (mp_font2.zip)
@ -78,6 +79,8 @@ Jens Hoffmann: <hoffmajs@gmx.de>
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
- russian DOCS translation
German Gomez Garcia: <german@piraos.com>
- DVD .ifo parser and chapter selection [not yet in the main trunk]

34
DOCS/MPlayer-FAQ
View File

@ -14,7 +14,7 @@ Q: What about DVD playback?
A: Read files 'DVD' and 'DVD-FAQ'.
Q: SDL output doesn't work or compile. Problem is ....
A: It is tested with SDL v1.2.0 (probably runs on 1.1.7+ too).
A: It is tested with newest SDL (probably runs on 1.1.7+).
It does NOT work with 1.1.6, 1.1.5 1.1.4 1.1.3 1.0.4 etc, don't ask.
Q: I am still having trouble compiling with SDL support. gcc says something
@ -33,14 +33,16 @@ A: copy DOCS/inttypes.h to MPlayer directory (cp DOCS/inttypes.h .)
try again... if fail, contact me
Q: I have Pentium III but ./configure doesn't detect SSE
A: Only kernel versions 2.4.x supports SSE (or try latest 2.2.19 or newer)
A: Only kernel versions 2.4.x supports SSE (or try latest 2.2.19 or newer, but
be prepared for problems)
Q: -xy option doesn't work with x11 driver (-vo x11)
A: x11 driver doesn't support scaling, but XF86VidMode support is now
used: you must specify the -vm and the -fs switch, and you're done.
Make sure you have the right Modelines in your XF86Config file, and
try if the DGA driver (and SDL's DGA driver, see VIDEOCARDS) works for you.
It's much faster. If even SDL's DGA works, it'll be EVEN more faster!
It's much faster. If SDL's DGA works too, use that, it'll be EVEN
faster!
Q: audio goes out of sync playing .avi file
A: try with -bps or -nobps option
@ -65,7 +67,7 @@ A: It's not zero, but it's built in into codec, so can't be measured separated.
You should try to play the file using -vo null and then -vo ... and check
the difference to see video_out speed...
Q: OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors)
Q: OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors/...)
A: your opengl driver doesn't support dynamic texture chanegs (glTexSubImage)
it's known not to work with X 4.0.x DRI drivers and nVidia's binary shit.
it's known to work with Utah-GLX and Matrox G400 card.
@ -100,20 +102,14 @@ A: It's a known bug (really it's a bug/limitation of the DLL codec)
Q: I've got 'MPlayer interrupted by signal 11' in module audio_setup or
decode_audio.
A: It's a damaged file with bad mp3 audio stream. Try it with -afm 4
A: This is highly unlikely, since the mp3lib rewrite. Contact us, it may be
a bug. Possibly it's a damaged file, try with -afm 4 .
Q: Are there rpm/deb/... packages of MPlayer?
A: You can make a .deb package for yourself, check DOCS/DEBIAN .
There are .rpm packages at
ftp://ftp.pld.org.pl/test/i386/
ftp://ftp.pld.org.pl/test/i586/
ftp://ftp.pld.org.pl/test/i686/
NOTE : it's _STRONGLY_ discouraged to make and distribute binary packages
of MPlayer, since it (currently) _highly_ depends on compile-time
options and optimizations!
NOTE: MANUAL COMPILATION _ALWAYS_ GIVES BETTER PERFORMANCE AND SPEED !
It's _STRONGLY_ discouraged to use binary packages
of MPlayer, since it (currently) _highly_ depends on compile-time
options and optimizations!
Q: Are there any mailing lists on MPlayer?
A: Yes! See README on how to subscribe them!
@ -121,7 +117,7 @@ A: Yes! See README on how to subscribe them!
Q: I've found a nasty bug when I tried to play my favourite video!!
Who should I inform?
A: Inform the MPlayer-users mailing list about your problem. *ALWAYS*
read the README about what information we NEED to identify your problem.
read the BUGREPORTS file about what information we NEED to identify your problem.
Use the developers addresses (specified in AUTHORS) only if you want to
flame, or want to ask for a date. ;)
@ -138,12 +134,14 @@ A: ...but you don't have the X development package installed. Or not
Q: I have problems playing files with ... codec. Can I use'em?
A: Check http://mplayer.sourceforge.net/DOCS/codecs.html,
if it doesn't contain your codec, contact us.
if it doesn't contain your codec, read
http://mplayer.sourceforge.net/DOCS/CODECS, and contact us.
Q: What about DGA driver? I can't find it!!!
A: ./configure autodetects your DGA driver. If -vo help doesn't show
DGA, then there's a problem with your X installation.
Try ./configure --enable-dga (and read VIDEOCARDS)
Alternatively, try SDL's DGA driver with '-vo sdl -sdl dga' options.
Q: Ok, -vo help shows DGA driver, but it is babbling about permissions!
Help me!
@ -211,5 +209,5 @@ A: Check 'ldd /usr/local/bin/mplayer' output. If it contains
Q: My computer plays M$ DivX AVIs with resolutions ~ 640x300 and stereo mp3
sound too slow. When I use -nosound switch, everything is ok (but quiet).
A: Those files probably have 48Khz audio, and your soundcard can't play
A: Those files probably have 48Khz audio, and your soundcard/driver can't play
it correctly. Audio downsampling isn't implemented in MPlayer (yet).

8
DOCS/OpenDivX
View File

@ -2,10 +2,10 @@
OpenDivX support in MPlayer
~~~~~~~~~~~~~~~~~~~~~~~~~~~
See http://www.projectmayo.com for details on the OpenDivX codec.
It's the opensource successor of the DivX codec, already available
on most platforms. We use an MMX-optimized Decore.
OpenDivX version supported in MPlayer : 4.0alpha48
See http://www.projectmayo.com for details on the OpenDivX codec. It's the
opensource successor of the DivX codec (really it's a somewhat enhanced version
of the MPEG-4 standard), already available on most platforms. We use an
MMX-optimized Decore. OpenDivX version supported in MPlayer : 4.0alpha48
Decoder:
~~~~~~~~

29
DOCS/README
View File

@ -8,7 +8,7 @@ MPlayer is a movie player for LINUX. It plays most mpeg, avi and asf files,
supported by many native and win32 DLL codecs. You can watch VCD, DVD and
even DivX movies too. The another big feature of mplayer is the wide range
of supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
fbdev, but you can use SDL (and this way all drivers of SDL) and some
fbdev, AAlib, but you can use SDL (and this way all drivers of SDL) and some
lowlevel card-specific drivers (for Matrox/3dfx/SiS) too! Most of them
supports software or hardware scaling, so you can enjoy movies in fullscreen.
And what about the nice big antialiased shaded subtitles (.sub files) with
@ -47,12 +47,13 @@ or speed problems too. So I've decided to write/modify one...
Try it, and be amazed! Thousands of new features added... and of course
old code was improved too, bugs removed etc.
As you see, I didn't write any codecs, just some players. But I spent
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 mpg 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!
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,
speed has lower priority, but is still very important.
@ -61,7 +62,7 @@ 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.
But there is a GUI development for the player, coordinated by Pontscho/Fresh!
It's still under development, but it will be merged and released soon.
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!!!
Supported input formats:
@ -92,8 +93,8 @@ The most important audio codecs:
- alaw, msgsm, pcm and other simple old audio formats
If you have a codec not listed here, and not supported yet, just
read DOCS/CODECS to get info about its status or about
how to help us adding support for it!
read http://mplayer.sourceforge.net/DOCS/codecs.html and DOCS/CODECS
to get info about its status and about how to help us adding support for it!
Supported video output devices:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -107,6 +108,7 @@ General:
- svga: Output to SVGAlib
- sdl: SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8
even support Xvideo (thus hardware rendering) and with >=1.2.0 aalib)
- aalib:Textmode rendering (through SDL, native driver is coming soon!)
Card specific:
- mga: Matrox G200/G400 hardware YUV overlay via the mga_vid device
@ -134,7 +136,7 @@ NOTE: check DOCS/SOUNDCARDS for details!
Speed:
~~~~~~
Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!.
Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!/3Dnow!Ex.
You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
Some *old* benchmark results can be found in the doc file SPEED.
@ -229,23 +231,26 @@ Mailing lists:
There are some public mailing lists on MPlayer. Subscribing can be achieved on
the following addresses:
- MPlayer core/hungarian developers list: (HUNGARIAN language ONLY!)
http://lists.sourceforge.net/lists/listinfo/mplayer-devel
- MPlayer developers list: (send your patches here)
http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng
- MPlayer users list: (send your ideas, bugreports, feature requests here)
http://lists.sourceforge.net/lists/listinfo/mplayer-users
- MPlayer & Matrox G200/G400/G450 users: (about TV-out, mga_vid, syncfb, Xv)
http://lists.sourceforge.net/lists/listinfo/mplayer-matrox
- MPlayer developers list: (send your patches here)
http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng
- MPlayer announce: (information about new releases or big changes in CVS)
http://lists.sourceforge.net/lists/listinfo/mplayer-announce
- MPlayer CVS-log: (announce about _every_ CVS commit)
http://lists.sourceforge.net/lists/listinfo/mplayer-cvslog
NOTE: language of above lists are ENGLISH. Please do not send there
messages using other language!
NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise.
Please do not send messages using other language!
License:
~~~~~~~~

15
DOCS/SOUNDCARDS
View File

@ -25,26 +25,23 @@ Gravis UltraSound MAX:
ALSA : OK (?)
Max kHz : 48
ESS 688 and probably all old SB's (without buffers):
OSS : OK (48Khz, somehow...)
ALSA : OK
Max kHz : 44.1
ESS 688:
OSS : OK
ALSA : OK (?)
Max kHz : 48
PC Speaker or DAC:
OSS : only with the new HQ timing code
(maybe won't work at all in the future)
ALSA : no driver
Max kHz : 6 ;) (the driver emulates 44.1 maybe more)
Driver : ftp://ftp.infradead.org/pub/pcsp
- MPlayer is mostly intended for OSS
- MPlayer is mostly intended for OSS, until we change to libxmm
- use at least 2.4 if possible, 2.2 isn't tested
- In case of any problems, first try recompiling with
./configure --disable-select , then make distclean ; make .
Your soundcard may not support querying of its buffer.
- if sound clicks when playing from CD-ROM, turn on IRQ unmasking !
for example "hdparm -u1 /dev/cdrom" (see "man hdparm" !!!)
This is recommended anyways... (for XMMS, etc...)
Read DOCS/CDROM .
- don't use your soundcard by other application ( for ex. XMMS ) !
if you use ESD, start MPlayer with the esddsp utility !
- Please tell us how MPlayer and your soundcard(s) worked together!

4
DOCS/TODO
View File

@ -11,10 +11,10 @@ They Have Been Around For A Long Time:
High Priority:
- finish ASF seeking (find next keyframe)
- asterix.avi audio delays after 5-10 mins (bps mode only)
- fix mp3lib to avoid segfault with some damaged .avi files
- fix mp3lib to avoid segfault with some damaged .avi files (DONE!?)
Medium Priority:
- seeking support for broken avi files without index chunk
- seeking support for broken avi files without index chunk (DONE!)
- fix x11 driver to work without SHM (for remote playing etc)
- show current frame number [Gabucino]
- seek_to_frame and seek_to_index options

12
DOCS/VIDEOCARDS
View File

@ -78,7 +78,7 @@ II. OpenGL drivers with *working* *fast* glTexSubImage() support.
Currently only the old Utah-GLX drivers (for X 3.3.6) have it.
See http://utah-glx.sourceforge.net for details about how to install it.
The new X4/DRI and nVidia's binary drivers has no usable glTexSubImage :(
The new X4/DRI and nVidia's binary drivers have no usable glTexSubImage :(
III. Native card-specific drivers
@ -88,10 +88,15 @@ There is 3 native drivers for Linux:
with triple buffering. It works on both framebuffer console and under X.
To use, simply compile the mga_vid.o in the drivers/ subdir (type: make)
and load it with insmod mga_vid.o. You should verify the memory size
create /dev/mga_vid device :
mknod /dev/mga_vid c 178 0
and load the driver with insmod mga_vid.o. You should verify the memory size
detection using the 'dmesg' command. If it's bad, use the mga_ram_size
option (rmmod mga_vid first), specify card's memory size in MB:
insmod mga_vid.o mga_ram_size=16
To make it load/unload automatically when needed, insert the following line
at the end of /etc/modules.conf :
alias char-major-178 mga_vid
Using it from MPlayer: (you should re-compile it with mga_vid support...)
@ -158,6 +163,7 @@ a, If you don't have X...
forced), and don't forget to edit /etc/vga/libvga.config to suit your
card & monitor.
Try the aalib target ('-vo sdl -sdl aalib'), it's great! :)
b, You want to use framebuffer...
... Whether to build the FBdev target is autodetected during ./configure .
@ -165,7 +171,7 @@ b, You want to use framebuffer...
(Documentation/fb/*) for info on how to enable it, etc.. !
... but your card doesn't support VBE 2.0 standard (older ISA/PCI
cards, such as S3 Trio64) :
cards, such as S3 Trio64), only VBE 1.2 (or older?) :
Well, VESAfb is still available, but you'll have to load SciTech Display
Doctor (formerly UniVBE) before booting Linux. Use a DOS boot disk or
whatever. And don't forget to register your UniVBE ;))